Како да прочитате дефиниција на функција (прототип)
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
Како да прочитате дефиниција на функција (прототип)
Референца за `about.prototypes.php` со подобрена типографија и навигација.
Како да прочитате дефиниција на функција (прототип)
Секоја функција во прирачникот е документирана за брзо повикување. Познавањето како да се чита и разбере текстот ќе го направи учењето на PHP многу полесно. Наместо да се потпирате на примери или копирање/лепење, секој треба да знае како да чита дефиниции на функции (прототипи). Да почнеме:
Забелешка: Предуслов: Основно разбирање на types
Иако PHP е јазик со лабава типовизација, важно е да имате основно разбирање на types бидејќи тие имаат важно значење.
Дефинициите на функциите ни кажуваат каков тип на вредност е returned. Ајде да ја користиме дефиницијата за strlen() како наш прв пример:
strlen (PHP 4, PHP 5, PHP 7) strlen -- Get string length Description strlen ( string $string ) : int Returns the length of given string.
| Дел | = NULL |
|---|---|
| strlen | Името на функцијата. |
| (PHP 4, PHP 5, PHP 7) | strlen() постои во сите верзии на PHP 4, 5 и 7 |
| ( string $string ) |
Првиот (и во овој случај единствен) параметар/аргумент за оваа функција се нарекува string, и тоа е
string.
|
| int | Тип на вредност што ја враќа оваа функција, што е int (т.е. должината на низата се мери во броеви). |
Можеме да ја препишеме горната дефиниција на функцијата на генерички начин:
function name ( parameter type parameter name ) : returned type
Многу функции прифаќаат повеќе параметри, како што е in_array(). Нејзиниот прототип е како што следува:
in_array ( mixed $needle, array $haystack , bool $strict = false ) : bool
Што значи ова? in_array() враќа
boolean вредност, true при успешно (ако needle беше пронајден во
haystackоператор за зголемување false при неуспех (ако
needle не беше пронајден во
haystack). Првиот параметар се вика
needle и може да биде од многу различни
types, па затоа го нарекуваме "mixed". Ова мешано needle
(она што го бараме) може да биде скаларна вредност (стринг, цел број, или float), или
array.
haystack (низата во која пребаруваме) е вториот параметар. Третиот optional параметар се вика strict. Сите опционални параметри имаат стандардни вредности; ако стандардната вредност е непозната, таа е прикажана како ?. Прирачникот наведува дека strict параметарот стандардно е буловски false. Погледнете ја страницата во прирачникот за секоја функција за детали за тоа како работат.
Дополнително, симболот & (амперсенд) пред параметарот на функцијата дозволува параметарот да се помине со reference, како што е прикажано подолу:
preg_match ( string $pattern , string $subject , array &$matches = null,
int $flags = 0 , int $offset = 0 ) : int|false
Во овој пример, можеме да го видиме третиот опционален параметар &$matches ќе биде предаден како референца.
Постојат и функции со посложени информации за верзијата на PHP. Земете html_entity_decode() како пример:
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
Ова значи дека оваа функција е достапна во објавена верзија само од PHP 4.3.0.