PHP: Cum se citeşte definiţia unei funcţii (prototipul)

Versiunile PHP documentate în acest manual

Last updated: Fri, 01 Aug 2008

Cum se citeşte definiţia unei funcţii (prototipul)

Fiecare funcţie din manual este documentată pentru referinţă rapidă. Ştiind cum se citeşte şi se interpretează textul va face studierea PHP mult mai facilă. În loc să se bazeze pe exemple sau pe 'tăiere/inserare', oricine ar trebui să ştie cum să citească definiţiile funcţiilor (prototipurile). Să începem:

Notă: Condiţie esenţială: Cunoştinţe de bază a tipurilor
Cu toate că PHP este un limbaj liber tipizat, este important de a avea cunoştinţe de bază a tipurilor deoarece ele au o însemnătate importantă.

Definiţiile functiilor ne spun ce tip de valoare este întoarsă. Să folosim definiţia pentru strlen() ca primul nostru exemplu:

strlen

(PHP 4, PHP 5)
strlen -- Obţine lungimea şirului de caractere

Descrierea
int strlen ( string $string )

Întoarce lungimea şirului dat de caractere.

**Explicaţia unei definiţii a funcţiei**
Partea	Descrierea
strlen	Numele funcţiei.
(PHP 4, PHP 5, PHP 6)	strlen() este prezentă în toate versiunile PHP 4, PHP 5 şi PHP 6
int	Tipul valorii, pe care această funcţie o întoarce, care este integer (adică lungimea şirului de caractere măsurată în numere).
( string $string )	Primul (şi în cazul dat unicul) parametru/argument pentru această funcţie este numit `string` , şi este de tipul string.

Am putea rescrie definiţia funcţiei anterioare într-o formă generică:

      tipul întors    numele funcţiei    ( tipul parametrului   numele parametrului )

Multe funcţii preiau parametri multipli, cum ar fi in_array(). Prototipul său este după cum urmează:

    
      bool in_array ( mixed $needle, array $haystack [, bool $strict])

Ce înseamnă aceasta? in_array() întoarce o valoare boolean, TRUE în cazul succesului (dacă needle a fost găsit în haystack ), sau FALSE în cazul eşecului (dacă needle nu a fost găsit în haystack ). Primul parametru este numit needle şi el poate fi de mai multe tipuri diferite, de aceea îl numim "mixed". Acest needle mixt (ceea ce căutăm) poate fi o valoare scalară (string, integer, sau float), sau un array. haystack (tabloul în care efectuăm căutarea) este al doilea parametru. Al treilea parametru opţional este numit strict . Toţi parametrii opţionali se găsesc între [ astfel de paranteze ]. Mmanual afirmă că parametrul strict are valoarea implicită boolean FALSE. Vedeţi pagina manualului referitoare la fiecare funcţie pentru detalii despre cum ea funcţionează.

Există funcţii cu informaţie mai complexă despre versiunea PHP. Să luăm html_entity_decode() ca exemplu:

    
(PHP 4 >= 4.3.0, PHP 5)

Aceasta înseamnă că această funcţie a devenit disponibilă numai începând cu versiunea PHP 4.3.0.

add a note User Contributed Notes
Cum se citeşte definiţia unei funcţii (prototipul)

php dot devel at homelinkcs dot com
13-Jul-2005 02: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
10-Mar-2005 12: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.

add a note

Versiunile PHP documentate în acest manual

Despre adnotările utilizatorilor

Last updated: Fri, 01 Aug 2008