Forum und email
O manuále
PHP Manual

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.

O manuále
PHP Manual