PHP
downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

Verzie PHP zdokumentované v tomto manuále> <O príspevkoch užívateľov
Last updated: Sun, 25 Nov 2007

view this page in

Ako čítať definíciu funkcie (prototyp)

Každá funkcia v manuále je zdokumentovaná v informačnej príručke. Znalosť, ako sa má text čítať a rozumieť, učenie PHP značne uľahčí. Namiesto odvolávania sa na príklady alebo vystrihnúť/vložiť, každý by mal vedieť ako čítať definície funkcií (prototypy). Začnime:

Note: Nevyhnutná podmienka: Základná interpretácia typov I keď PHP je len poľahky typovým jazykom, je dôležité mať základné vedomosti o typoch, pretože majú dôležitý význam.

Definície funkcií nám hovoria aký typ hodnoty je vrátený. Použijeme definíciu pre strlen(), ako náš prvý príklad:

strlen

(PHP 3, PHP 4, PHP 5)
strlen -- Určí dĺžku retažca

Popis
int strlen ( string str )

Vráti dĺžku reťazca.

Vysvetlenie funkčnej definície
Časť Popis
strlen Názov funkcie.
(PHP 3, PHP 4, PHP 5) strlen() je k dispozícii vo všetkých verziách PHP 3, PHP 4 a PHP 5
int Typ hodnoty, ktorú táto funkcia vracia, čo je integer (t.j. dĺžka reťazca sa udáva v číslach).
( string str ) Prvý (a v tomto prípade jediný) parameter/argument pre túto funkciu sa nazýva str a je to string.

Definíciu horeuvedenej funkcie by sme mohli prepísať do všeobecného tvaru:

      vrátený typ    názov funkcie    ( typ parametra   názov parametra )

Mnoho funkcií má viacero parametrov, ako má napr. in_array(). Jeho prototyp vyzerá následovne:

    
      bool in_array (mixed ihla, array stoh_sena [, bool strict])

Čo to vlastne znamená? in_array() vracia hodnotu boolean, TRUE ak je pravdivý (ak ihla bola nájdená v stoh_sena ) alebo FALSE pri chybe (ak sa ihla nenašla v stoh_sena ). Prvý parameter je pomenovaný ihla a môže byť viacerých typov, takže sme ho nazvali "mixed". Táto mixed ihla (ktorú hľadáme) može byť buď skalárna hodnota (string, integer, alebo float) alebo array. stoh_sena (pole, v ktorom hľadáme) je druhý parameter. Tretí voliteľný parameter je pomenovaný strict . Všetky voliteľné parametre sú uzavreté do [ zátvoriek ]. Manuál ukladá, že parameter strict je štandardne nastevený na boolean FALSE. Pozri manuálovú stránku pre každú funkciu a ako fungujú.

Existujú tiež funkcie s komplexnejšími informácia mi o PHP verii. Berte html_entity_decode() za príklad:

    
      (PHP 4 >= 4.3.0, PHP 5)

Toto znamená, že táto funkcia nebola dostupná v PHP 3 a je dostupná len vo vydanej verzii od PHP 4.3.0.



add a note add a note User Contributed Notes
Ako čítať definíciu funkcie (prototyp)
php dot devel at homelinkcs dot com
12-Jul-2005 05:50
More specifically, an ampersand (&) prepended to an argument name means that the argument will be passed by reference (http://www.php.net/manual/en/language.references.pass.php).
ceo at l-i-e dot com
09-Mar-2005 03:16
Another thing to watch for is the & in the argument list.

That generally means that the function is going to *CHANGE* the value you pass in, in some way, and you can't rely on it being the same as what you handed off to the function.

 
show source | credits | stats | sitemap | contact | advertising | mirror sites