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

search for in the

Версии на PHP, документирани в това ръководство> <Относно потребителските бележки
Last updated: Fri, 02 Jan 2009

view this page in

Как се четат дефинициите на функциите (прототипи)

Всяка функция е документирана за бърза справка. Познанието за това как се чете ръководството и неговото разбиране ще направи използването на PHP много по-лесно. Вместо да се осланяте на примери или cut/paste, вие по-скоро ще искате да знаете как да четете дефинициите на функциите (прототипи). Нека започнем:

Забележка: Необходимо условие: Основно разбиране на типовете
Въпреки че PHP не е строго типов език, е важно да имате основна представа от типове, тъй като те имат важно значение.

Дефинициите на функциите ни казват какъв тип е връщаната стойност. Да използваме дефиницията на strlen() за наш първи пример:

strlen

(PHP 3, PHP 4 >= 4.0.0)
strlen -- Вземане дължината на низ

Описание
int strlen ( string str )

Връща дължината на низ.
    

Обяснение на дефиницията
Част Описание
strlen Името на функцията.
(PHP 3, PHP 4 >= 4.0.0) strlen() съществува и в PHP 3 и в PHP 4
int Типът стойност, връщана от тази функция, който е integer (Дължината на низ се измерва с числа).
( string str ) Първият (и в случая - единствен) параметър/аргумент за функцията strlen() се нарича str и е string.

Можем да пренапишем по-горната дефиниция на функция в общ вид:

      връщан тип    име на функция    ( тип на параметъра    име на параметъра )
     

Много функции, като in_array(), приемат множество параметри. Нейният прототип е както следва:

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

Какво означава това? in_array() връща boolean стойност, TRUE при успех (ако needle е бил намерен в haystack ) или FALSE при неуспех (ако needle не е бил намерен в haystack ). Първият параметър се нарича needle и може да бъде много различни типове, така че го наричаме "mixed" (смесен). Този смесен needle (това, което търсим) може да бъде или скаларна стойност (string, integer или float) или array. haystack (масивът, в който търсим) е втория параметър. Третият незадължителен параметър се нарича strict . Всички незадължителни параметри са в [ квадратни скоби ]. Ръководството упоменава, че параметърът strict има стойност по подразбиране boolean FALSE. За повече информация относно това, как работят самите функции, погледнете съответните страници в ръководството.



add a note add a note User Contributed Notes
Как се четат дефинициите на функциите (прототипи)
php dot devel at homelinkcs dot com
13-Jul-2005 03: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 01: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 | sitemap | contact | advertising | mirror sites