cvs: phpdoc-ru /language functions.xml
| From: | Alexander Voytsekhovskyy | Date: | Fri, 04 Jun 2004 14:29:01 +0000 |
| Subject: | cvs: phpdoc-ru /language functions.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-360@lists.php.net to get a copy of this message | ||
young Fri Jun 4 10:29:01 2004 EDT
Added files:
/phpdoc-ru/language functions.xml
Log:
Add new translated file
http://cvs.php.net/co.php/phpdoc-ru/language/functions.xml?r=1.1&p=1 Index: phpdoc-ru/language/functions.xml +++ phpdoc-ru/language/functions.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.47 Maintainer: young Status: ready --> <chapter id="language.functions"> <title>Ôóíêöèè</title> <sect1 id="functions.user-defined"> <title>Ôóíêöèè, îïðåäåëÿåìûå ïîëüçîâàòåëåì</title> <para> Ïðèâåäåì ïðèìåð ñèíòàêñèñà, èñïîëüçóåìîãî äëÿ îïèñàíèÿ ôóíêöèé: </para> <para> <example> <title>Ïñåâäîêîä äëÿ äåìîíñòðàöèè èñïîëüçîâàíèÿ ôóíêöèé</title> <programlisting role="php"> <![CDATA[ <?php function foo($arg_1, $arg_2, /* ..., */ $arg_n) { echo "Example function.\n"; return $retval; } ?> ]]> </programlisting> </example> </para> <!-- status of func(const $param) ? zend doesn't care at all whether or not you specify it. I've never seen it before... what's its use? (or was...) --> <simpara> Âíóòðè ôóíêöèè ìîæíî èñïîëüçîâàòü ëþáîé êîððåêòíûé PHP-êîä, â òîì ÷èñëå äðóãèå ôóíêöèè è äàæå îáúÿâëåíèÿ <link linkend="keyword.class">êëàññîâ</link>. </simpara> <simpara>  PHP 3 ôóíêöèè äîëæíû áûëè áûòü îïðåäåëåíû ïðåæäå, ÷åì îíè áóäóò èñïîëüçîâàíû.  PHP 4 òàêîãî îãðàíè÷åíèÿ íåò, <emphasis>èñêëþ÷àÿ</emphasis> òîò ñëó÷àé, êîãäà ôóíêöèè îïðåäåëÿþòñÿ óñëîâíî, êàê ýòî ïîêàçàíî â äâóõ ïîñëåäóþùèõ ïðèìåðàõ. </simpara> <para>  ñëó÷àå, êîãäà ôóíêöèÿ îïðåäåëÿåòñÿ â çàâèñèìîñòè îò êàêîãî-ëèáî óñëîâèÿ, íàïðèìåð, êàê ýòî ïîêàçàíî â äâóõ ïðèâåäåííûõ íèæå ïðèìåðàõ, îáðàáîòêà îïèñàíèÿ ôóíêöèè äîëæíà <emphasis>ïðåäøåñòâîâàòü</emphasis> åå âûçîâó. </para> <para> <example> <title>Ôóíêöèè, çàâèñÿùèå îò óñëîâèé</title> <programlisting role="php"> <![CDATA[ <?php $makefoo = true; /* Ìû íå ìîæåì âûçâàòü ôóíêöèþ foo() â ýòîì ìåñòå, ïîñêîëüêó îíà åùå íå îïðåäåëåíà, íî ìû ìîæåì îáðàòèòüñÿ ê bar() */ bar(); if ($makefoo) { function foo() { echo "I don't exist until program execution reaches me.\n"; } } /* Òåïåðü ìû áëàãîïîëó÷íî ìîæåì âûçûâàòü foo(), ïîñêîëüêó $makefoo áûëà èíòåðïðåòèðîâàíà êàê true */ if ($makefoo) foo(); function bar() { echo "I exist immediately upon program start.\n"; } ?> ]]> </programlisting> </example> </para> <para> <example> <title>Âëîæåííûå ôóíêöèè</title> <programlisting role="php"> <![CDATA[ <?php function foo() { function bar() { echo "I don't exist until foo() is called.\n"; } } /* Ìû ïîêà íå ìîæåì îáðàòèòüñÿ ê bar(), ïîñêîëüêó îíà åùå íå îïðåäåëåíà. */ foo(); /* Òåïåðü ìû ìîæåì âûçâàòü ôóíêöèþ bar(), îáðàáîòêà foo() ñäåëàëà åå äîñòóïíîé. */ bar(); ?> ]]> </programlisting> </example> </para> <simpara> PHP íå ïîääåðæèâàåò ïåðåãðóçêó ôóíêöèè, òàêæå îòñóòñòâóåò âîçìîæíîñòü ïåðåîïðåäåëèòü èëè óäàëèòü îáúÿâëåííóþ ðàíåå ôóíêöèþ. </simpara> <note> <simpara> Èìåíà ôóíêöèé ðåãèñòðîíåçàâèñèìû, òåì íå ìåíåå, áîëåå ïðåäïî÷òèòåëüíî âûçûâàòü ôóíêöèè òàê, êàê îíè áûëè îáúÿâëåíû. </simpara> </note> <simpara> PHP 3 íå ïîääåðæèâàåò ïåðåìåííîå êîëè÷åñòâî àðãóìåíòîâ ôóíêöèè, õîòÿ ïîääåðæêà çíà÷åíèé ïî óìîë÷àíèþ äëÿ àðãóìåíòîâ ïðèñóòñòâóåò (ñìîòðèòå ðàçäåë <link linkend="functions.arguments.default">Çíà÷åíèÿ àðãóìåíòîâ ïî óìîë÷àíèþ</link>). PHP 4 ïîääåðæèâàåò è òî, è äðóãîå: ñìîòðèòå ðàçäåë <link linkend="functions.variable-arg-list">Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû </link> è îïèñàíèÿ ôóíêöèé <function>func_num_args</function>, <function>func_get_arg</function>, è <function>func_get_args</function> äëÿ áîëåå äåòàëüíîé èíôîðìàöèè. </simpara> </sect1> <sect1 id="functions.arguments"> <title>Àðãóìåíòû ôóíêöèè</title> <simpara> Ôóíêöèÿ ìîæåò ïðèíèìàòü èíôîðìàöèþ â âèäå ñïèñêà àðãóìåíòîâ, êîòîðûé ÿâëÿåòñÿ ñïèñêîì ðàçäåëåííûõ çàïÿòûìè ïåðåìåííûõ è/èëè êîíñòàíò. </simpara> <para> PHP ïîääåðæèâàåò ïåðåäà÷ó àðãóìåíòîâ ïî çíà÷åíèþ (ïî óìîë÷àíèþ), <link linkend="functions.arguments.by-reference">ïåðåäà÷ó àðãóìåíòîâ ïî ññûëêå</link>, è <link linkend="functions.arguments.default">çíà÷åíèÿ ïî óìîë÷àíèþ</link>. Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû ïîääåðæèâàþòñÿ, íà÷èíàÿ ñ PHP 4: ñìîòðèòå ðàçäåë <link linkend="functions.variable-arg-list">Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû </link> è îïèñàíèÿ ôóíêöèé <function>func_num_args</function>, <function>func_get_arg</function> è <function>func_get_args</function> äëÿ áîëåå äåòàëüíîé èíôîðìàöèè. Ïîäîáíîãî ýôôåêòà ìîæíî äîñòè÷ü â PHP 3, ïåðåäàâàÿ ôóíêöèè ìàññèâ àðãóìåíòîâ: </para> <para> <example> <title>Ïåðåäà÷à ìàññèâà â ôóíêöèþ</title> <programlisting role="php"> <![CDATA[ <?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } ?> ]]> </programlisting> </example> </para> <sect2 id="functions.arguments.by-reference"> <title>Ïåðåäà÷à àðãóìåíòîâ ïî ññûëêå</title> <simpara> Ïî óìîë÷àíèþ àðãóìåíòû â ôóíêöèþ ïåðåäàþòñÿ ïî çíà÷åíèþ (ýòî îçíà÷àåò, ÷òî åñëè âû èçìåíèòå çíà÷åíèå àðãóìåíòà âíóòðè ôóíêöèè, òî âíå åå çíà÷åíèå âñå ðàâíî îñòàíåòñÿ ïðåæíèì). Åñëè âû õîòèòå ðàçðåøèòü ôóíêöèè ìîäèôèöèðîâàòü ñâîè àðãóìåíòû, âû äîëæíû ïåðåäàâàòü èõ ïî ññûëêå. </simpara> <para> Åñëè âû õîòèòå, ÷òî áû àðãóìåíò âñåãäà ïåðåäàâàëñÿ ïî ññûëêå, âû ìîæåòå óêàçàòü àìïåðñàíä (&) ïåðåä èìåíåì àðãóìåíòà â îïèñàíèè ôóíêöèè: </para> <para> <example> <title>Ïåðåäà÷à àðãóìåíòîâ ïî ññûëêå</title> <programlisting role="php"> <![CDATA[ <?php function add_some_extra(&$string) { $string .= 'and something extra.'; } $str = 'This is a string, '; add_some_extra($str); echo $str; // Âûâåäåò 'This is a string, and something extra.' ?> ]]> </programlisting> </example> </para> </sect2> <sect2 id="functions.arguments.default"> <title>Çíà÷åíèÿ àðãóìåíòîâ ïî óìîë÷àíèþ</title> <para> Ôóíêöèÿ ìîæåò îïðåäåëÿòü çíà÷åíèÿ ïî óìîë÷àíèþ â ñòèëå C++ äëÿ ñêàëÿðíûõ àðãóìåíòîâ, íàïðèìåð: </para> <para> <example> <title>Èñïîëüçîâàíèå çíà÷åíèé ïî óìîë÷àíèþ â îïðåäåëåíèè ôóíêöèè</title> <programlisting role="php"> <![CDATA[ <?php function makecoffee($type = "cappuccino") { return "Making a cup of $type.\n"; } echo makecoffee(); echo makecoffee("espresso"); ?> ]]> </programlisting> </example> </para> <para> Ðåçóëüòàò ðàáîòû ïðèâåäåííîãî âûøå êîäà áóäåò òàêèì: </para> <para> <screen> Making a cup of cappuccino. Making a cup of espresso. </screen> </para> <para> PHP òàêæå ïîçâîëÿåò èñïîëüçîâàòü ìàññèâû è ñïåöèàëüíûé òèï NULL â êà÷åñòâå çíà÷åíèé ïî óìîë÷àíèþ, íàïðèìåð: </para> <para> <example> <title>Èñïîëüçîâàíèå íåñêàëÿðíûõ òèïîâ â êà÷åñòâå çíà÷åíèé ïî óìîë÷àíèþ</title> <programlisting role="php"> <![CDATA[ <?php function makecoffee($types = array("cappuccino"), $coffeeMaker = NULL) { $device = is_null($coffeeMaker) ? "hands" : $coffeeMaker; return "Making a cup of ".join(", ", $types)." with $device.\n"; } echo makecoffee(); echo makecoffee(array("cappuccino", "lavazza"), "teapot"); ?> ]]> </programlisting> </example> </para> <simpara> Çíà÷åíèå ïî óìîë÷àíèþ äîëæíî áûòü êîíñòàíòíûì âûðàæåíèåì, à íå (ê ïðèìåðó) ïåðåìåííîé èëè âûçîâîì ôóíêöèè/ìåòîäà êëàññà. </simpara> <para> Îáðàòèòå âíèìàíèå, ÷òî âñå àðãóìåíòû, äëÿ êîòîðûõ óñòàíîâëåíû çíà÷åíèÿ ïî óìîë÷àíèþ, äîëæíû íàõîäèòñÿ ïðàâåå àðãóìåíòîâ, äëÿ êîòîðûõ çíà÷åíèÿ ïî óìîë÷àíèþ íå çàäàíû, â ïðîòèâíîì ñëó÷àå âàø êîä ìîæåò ðàáîòàòü íå òàê, êàê âû ýòîãî îæèäàåòå. Ðàññìîòðèì ñëåäóþùèé ïðèìåð: </para> <para> <example> <title>Íåêîððåêòíîå èñïîëüçîâàíèå çíà÷åíèé ïî óìîë÷àíèþ</title> <programlisting role="php"> <![CDATA[ <?php function makeyogurt($type = "acidophilus", $flavour) { return "Making a bowl of $type $flavour.\n"; } echo makeyogurt("raspberry"); // Íå áóäåò ðàáîòàòü òàê, êàê ìû ìîãëè áû îæèäàòü ?> ]]> </programlisting> </example> </para> <para> Ðåçóëüòàò ðàáîòû ïðèâåäåííîãî âûøå ïðèìåðà áóäåò ñëåäóþùèì: </para> <para> <screen> Warning: Missing argument 2 in call to makeyogurt() in /usr/local/etc/httpd/htdocs/php3test/functest.html on line 41 Making a bowl of raspberry . </screen> </para> <para> Òåïåðü ñðàâíèì ýãî ñî ñëåäóþùèì ïðèìåðîì: </para> <para> <example> <title>Íåêîððåêòíîå èñïîëüçîâàíèå çíà÷åíèé ïî óìîë÷àíèþ</title> <programlisting role="php"> <![CDATA[ <?php function makeyogurt($flavour, $type = "acidophilus") { return "Making a bowl of $type $flavour.\n"; } echo makeyogurt("raspberry"); // îòðàáàòûâàåò ïðàâèëüíî ?> ]]> </programlisting> </example> </para> <para> Òåïåðü ðåçóëüòàò ðàáîòû ïðèìåðà áóäåò âûãëÿäåòü òàê: </para> <para> <screen> Making a bowl of acidophilus raspberry. </screen> </para> </sect2> <sect2 id="functions.variable-arg-list"> <title>Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû</title> <simpara> PHP 4 ïîääåðæèâàåò ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû äëÿ ôóíêöèé, îïðåäåëÿåìûõ ïîëüçîâàòåëåì. Ðåàëèçàöèÿ ýòîé âîçìîæíîñòè äîñòàòî÷íî ïðîçðà÷íà è çàêëþ÷àåòñÿ â èñïîëüçîâàíèè ôóíêöèé <function>func_num_args</function>, <function>func_get_arg</function> è <function>func_get_args</function>. </simpara> <simpara> Íåîáõîäèìîñòè â ñïåöèôè÷åñêîì ñèíòàêñèñå íåò, ïðè ýòîì ñïèñîê àðãóìåíòîâ òàêæå ìîæåò áûòü óêàçàí ÿâíî è áóäåò îáëàäàòü òåì æå ïîâåäåíèåì. </simpara> </sect2> </sect1> <sect1 id="functions.returning-values"> <title>Âîçâðàò çíà÷åíèé</title> <para> Çíà÷åíèÿ âîçâðàùàþòñÿ ïðè ïîìîùè íåîáÿçàòåëüíîãî îïåðàòîðà âîçâðàòà. Âîçâðàùàåìûå çíà÷åíèÿ ìîãóò áûòü ëþáîãî òèïà, â òîì ÷èñëå ýòî ìîãóò áûòü ñïèñêè è îáúåêòû. Âîçâðàò ïðèâîäèò ê çàâåðøåíèþ âûïîëíåíèÿ ôóíêöèè è ïåðåäà÷å óïðàâëåíèÿ îáðàòíî ê òîé ñòðîêå êîäà, â êîòîðîé äàííàÿ ôóíêöèÿ áûëà âûçâàíà. Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè îçíàêîìüòåñü ñ îïèñàíèåì ôóíêöèè <function>return</function>. </para> <para> <example> <title>Èñïîëüçîâàíèå ôóíêöèè <function>return</function></title> <programlisting role="php"> <![CDATA[ <?php function square($num) { return $num * $num; } echo square(4); // âûâîäèò '16'. ?> ]]> </programlisting> </example> </para> <para> Ôóíêöèÿ íå ìîæåò âîçâðàùàòü íåñêîëüêî çíà÷åíèé, íî àíàëîãè÷íîãî ðåçóëüòàòà ìîæíî äîáèòüñÿ, âîçâðàùàÿ ìàññèâ. </para> <para> <example> <title>Âîçâðàò íåñêîëüêèõ çíà÷åíèé â âèäå ìàññèâà</title> <programlisting role="php"> <![CDATA[ <?php function small_numbers() { return array (0, 1, 2); } list ($zero, $one, $two) = small_numbers(); ?> ]]> </programlisting> </example> </para> <para> Äëÿ òîãî, ÷òîáû ôóíêöèÿ âîçâðàùàëà ðåçóëüòàò ïî ññûëêå, âàì íåîáõîäèìî èñïîëüçîâàòü îïåðàòîð & è ïðè îïèñàíèè ôóíêöèè, è ïðè ïðèñâîåíèè ïåðåìåííîé âîçâðàùàåìîãî çíà÷åíèÿ: </para> <para> <example> <title>Âîçâðàò ðåçóëüòàòà ïî ññûëêå</title> <programlisting role="php"> <![CDATA[ <?php function &returns_reference() { return $someref; } $newref =& returns_reference(); ?> ]]> </programlisting> </example> </para> <simpara> Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè î ññûëêàõ îáðàòèòåñü ê ðàçäåëó äîêóìåíòàöèè <link linkend="language.references">Ïîäðîáíî îá óêàçàòåëÿõ</link>. </simpara> </sect1> <sect1 id="functions.variable-functions"> <title>Îáðàùåíèå ê ôóíêöèÿì ÷åðåç ïåðåìåííûå</title> <para> PHP ïîääåðæèâàåò êîíöåïöèþ ïåðåìåííûõ ôóíêöèé. Ýòî îçíà÷àåò, ÷òî åñëè ê èìåíè ïåðåìåííîé ïðèñîåäèíåíû êðóãëûå ñêîáêè, PHP èùåò ôóíêöèþ ñ òåì æå èìåíåì, ÷òî è ðåçóëüòàò âû÷èñëåíèÿ ïåðåìåííîé, è ïûòàåòñÿ åå âûïîëíèòü. Ýòó âîçìîæíîñòü ìîæíî èñïîëüçîâàòü äëÿ ðåàëèçàöèè îáðàòíûõ âûçîâîâ, òàáëèö ôóíêöèé è ìíîæåñòâà äðóãèõ âåùåé. </para> <para> Ïåðåìåííûå ôóíêöèè íå áóäóò ðàáîòàòü ñ òàêèìè ÿçûêîâûìè êîíñòðóêöèÿìè êàê <function>echo</function>, <function>print</function>, <function>unset</function>, <function>isset</function>, <function>empty</function>, <function>include</function>, <function>require</function> è äðóãèìè ïîäîáíûìè èì îïåðàòîðàìè. Âàì íåîáõîäèìî ðåàëèçîâûâàòü ñâîþ ôóíêöèþ-îáåðòêó (wrapper) äëÿ òîãî, ÷òîáû ïðèâåäåííûå âûøå êîíñòðóêöèè ìîãëè ðàáîòàòü ñ ïåðåìåííûìè ôóíêöèÿìè. </para> <para> <example> <title>Ðàáîòà ñ ôóíêöèÿìè ïîñðåäñòâîì ïåðåìåííûõ</title> <programlisting role="php"> <![CDATA[ <?php function foo() { echo "In foo()<br />\n"; } function bar($arg = '') { echo "In bar(); argument was '$arg'.<br />\n"; } // Ôóíêöèÿ-îáåðòêà äëÿ echo function echoit($string) { echo $string; } $func = 'foo'; $func(); // Âûçûâàåò ôóíêöèþ foo() $func = 'bar'; $func('test'); // Âûçûâàåò ôóíêöèþ bar() $func = 'echoit'; $func('test'); // Âûçûûâåò ôóíêöèþ echoit() ?> ]]> </programlisting> </example> </para> <para> Âû òàêæå ìîæåòå âûçâàòü ìåòîäû îáúåêòà, èñïîëüçóÿ âîçìîæíîñòè PHP äëÿ ðàáîòû ñ ïåðåìåííûìè ôóíêöèÿìè. <example> <title>Îáðàùåíèå ê ìåòîäàì êëàññà ïîñðåäñòâîì ïåðåìåííûõ</title> <programlisting role="php"> <![CDATA[ <?php class Foo { function Variable() { $name = 'Bar'; $this->$name(); // Âûçûâàåì ìåòîä Bar() } function Bar() { echo "This is Bar"; } } $foo = new Foo(); $funcname = "Variable"; $foo->$funcname(); // Îáðàùàåìñÿ ê $foo->Variable() ?> ]]> </programlisting> </example> </para> <para> Ñìîòðèòå òàêæå <function>call_user_func</function>, <link linkend="language.variables.variable">Ïåðåìåííûå ïåðåìåííûå</link> è <function>function_exists</function>. </para> </sect1> <sect1 id="functions.internal"> <title>Âñòðîåííûå ôóíêöèè</title> <para>  ñàìîì PHP ñîäåðæèòñÿ äîñòàòî÷íî áîëüøîå êîëè÷åñòâî âñòðîåííûõ ôóíêöèé è ÿçûêîâûõ êîíñòðóêöèé. Òàêæå åñòü ôóíêöèè, êîòîðûå òðåáóþò, ÷òîáû PHP áûë ñîáðàí ñî ñïåöèôè÷åñêèìè ðàñøèðåíèÿìè, â ïðîòèâíîì ñëó÷àå âû ïîëó÷èòå ñîîáùåíèå îá îøèáêå, âûçâàííîé èñïîëüçîâàíèåì íåèçâåñòíîé ôóíêöèè. Íàïðèìåð, äëÿ òîãî ÷òîáû èñïîëüçîâàòü <link linkend="ref.image">Ôóíêöèè äëÿ ðàáîòû ñ èçîáðàæåíèÿìè</link>, íàïðèìåð <function>imagecreatetruecolor</function>, âàì íåîáõîäèìî ñîáðàòü PHP ñ ïîääåðæêîé <productname>GD</productname>. Èëè æå äëÿ òîãî, ÷òîáû âîñïîëüçîâàòüñÿ ôóíêöèåé <function>mysql_connect</function>, âàì íåîáõîäèìà ïîääåðæêà ìîäóëÿ <link linkend="ref.mysql">MySQL</link>. Òåì íå ìåíåå, åñòü ìíîãî âñòðîåííûõ ôóíêöèé, êîòîðûå äîñòóïíû âñåãäà: íàïðèìåð <link linkend="ref.strings">Ôóíêöèè îáðàáîòêè ñòðîê</link> è <link linkend="ref.var">Ôóíêöèè äëÿ ðàáîòû ñ ïåðåìåííûìè</link>. Âûçâàâ <function>phpinfo</function> èëè <function>get_loaded_extensions</function>, âû ìîæåòå óçíàòü, ïîääåðæêà êàêèõ ìîäóëåé åñòü â èñïîëüçóåìîì âàìè PHP. Òàêæå ñëåäóåò ó÷åñòü, ÷òî ïîääåðæêà íåêîòîðûõ äîïîëíèòåëüíûõ ðàñøèðåíèé âêëþ÷åíà ïî óìîë÷àíèþ, è ÷òî ñàìà äîêóìåíòàöèÿ ê PHP ðàçáèòà ïî ðàñøèðåíèÿì. Îçíàêîìüòåñü ñ ðàçäåëàìè <link linkend="configuration">Êîíôèãóðàöèÿ</link>, <link linkend="installation">Óñòàíîâêà</link>, à òàêæå ñ äîêóìåíòàöèåé íåïîñðåäñòâåííî ê äîïîëíèòåëüíûì ðàñøèðåíèÿì äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè î òîì, êàê íàñòðîèòü âàø PHP. </para> <para> Áîëåå ïîäðîáíóþ èíôîðìàöèþ î òîì, êàê ñëåäóåò ÷èòàòü è èíòåðïðåòèðîâàòü ïðîòîòèïû ôóíêöèé, âû ìîæåòå íàéòè â ðàçäåëå <link linkend="about.prototypes">Êàê ïðàâèëüíî ÷èòàòü îïèñàíèÿ ôóíêöèé</link>. Î÷åíü âàæíî ïîíèìàòü, ÷òî âîçâðàùàåò ôóíêöèÿ, èëè êàê èìåííî îíà ìîäèôèöèðóåò ïåðåäàâàåìûå àðãóìåíòû. Íàïðèìåð, ôóíêöèÿ <function>str_replace</function> âîçâðàùàåò ìîäèôèöèðîâàííóþ ñòðîêó, â òî âðåìÿ êàê ôóíêöèÿ <function>usort</function> ðàáîòàåò ñ ôàêòè÷åñêè ïåðåäàííîé ïåðåìåííîé. Êàæäàÿ ñòðàíèöà äîêóìåíòàöèè òàêæå ñîäåðæèò èíôîðìàöèþ, êîòîðàÿ ñïåöèôè÷íà äëÿ äàííîé ôóíêöèè, íàïðèìåð, èíôîðìàöèþ î ïåðåäàâàåìûõ ïàðàìåòðàõ, èçìåíåíèÿõ â ïîâåäåíèè, âîçâðàùàåìûõ çíà÷åíèÿõ â ñëó÷àå êàê óäà÷íîãî, òàê è íåóäà÷íîãî âûïîëíåíèÿ, äîñòóïíîñòè ôóíêöèè â ðàçëè÷íûõ âåðñèÿõ. Çíàíèå è ïðèìåíåíèå ýòèõ (ïîðîé äàæå íåçàìåòíûõ) íþàíñîâ î÷åíü âàæíî äëÿ íàïèñàíèÿ êîððåêòíîãî PHP-êîäà. </para> <para> Îçíàêîìüòåñü òàêæå ñî <link linkend="funcref">Ñïðàâî÷íèêîì ôóíêöèé</link> è áîëåå äåòàëüíûìè îïèñàíèÿìè ôóíêöèé <function>function_exists</function>, <function>get_extension_funcs</function> è <function>dl</function>. </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/phpdoc-ru/language/functions.xml?r=1.1&p=1 Index: phpdoc-ru/language/functions.xml +++ phpdoc-ru/language/functions.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.47 Maintainer: young Status: ready --> <chapter id="language.functions"> <title>Ôóíêöèè</title> <sect1 id="functions.user-defined"> <title>Ôóíêöèè, îïðåäåëÿåìûå ïîëüçîâàòåëåì</title> <para> Ïðèâåäåì ïðèìåð ñèíòàêñèñà, èñïîëüçóåìîãî äëÿ îïèñàíèÿ ôóíêöèé: </para> <para> <example> <title>Ïñåâäîêîä äëÿ äåìîíñòðàöèè èñïîëüçîâàíèÿ ôóíêöèé</title> <programlisting role="php"> <![CDATA[ <?php function foo($arg_1, $arg_2, /* ..., */ $arg_n) { echo "Example function.\n"; return $retval; } ?> ]]> </programlisting> </example> </para> <!-- status of func(const $param) ? zend doesn't care at all whether or not you specify it. I've never seen it before... what's its use? (or was...) --> <simpara> Âíóòðè ôóíêöèè ìîæíî èñïîëüçîâàòü ëþáîé êîððåêòíûé PHP-êîä, â òîì ÷èñëå äðóãèå ôóíêöèè è äàæå îáúÿâëåíèÿ <link linkend="keyword.class">êëàññîâ</link>. </simpara> <simpara>  PHP 3 ôóíêöèè äîëæíû áûëè áûòü îïðåäåëåíû ïðåæäå, ÷åì îíè áóäóò èñïîëüçîâàíû.  PHP 4 òàêîãî îãðàíè÷åíèÿ íåò, <emphasis>èñêëþ÷àÿ</emphasis> òîò ñëó÷àé, êîãäà ôóíêöèè îïðåäåëÿþòñÿ óñëîâíî, êàê ýòî ïîêàçàíî â äâóõ ïîñëåäóþùèõ ïðèìåðàõ. </simpara> <para>  ñëó÷àå, êîãäà ôóíêöèÿ îïðåäåëÿåòñÿ â çàâèñèìîñòè îò êàêîãî-ëèáî óñëîâèÿ, íàïðèìåð, êàê ýòî ïîêàçàíî â äâóõ ïðèâåäåííûõ íèæå ïðèìåðàõ, îáðàáîòêà îïèñàíèÿ ôóíêöèè äîëæíà <emphasis>ïðåäøåñòâîâàòü</emphasis> åå âûçîâó. </para> <para> <example> <title>Ôóíêöèè, çàâèñÿùèå îò óñëîâèé</title> <programlisting role="php"> <![CDATA[ <?php $makefoo = true; /* Ìû íå ìîæåì âûçâàòü ôóíêöèþ foo() â ýòîì ìåñòå, ïîñêîëüêó îíà åùå íå îïðåäåëåíà, íî ìû ìîæåì îáðàòèòüñÿ ê bar() */ bar(); if ($makefoo) { function foo() { echo "I don't exist until program execution reaches me.\n"; } } /* Òåïåðü ìû áëàãîïîëó÷íî ìîæåì âûçûâàòü foo(), ïîñêîëüêó $makefoo áûëà èíòåðïðåòèðîâàíà êàê true */ if ($makefoo) foo(); function bar() { echo "I exist immediately upon program start.\n"; } ?> ]]> </programlisting> </example> </para> <para> <example> <title>Âëîæåííûå ôóíêöèè</title> <programlisting role="php"> <![CDATA[ <?php function foo() { function bar() { echo "I don't exist until foo() is called.\n"; } } /* Ìû ïîêà íå ìîæåì îáðàòèòüñÿ ê bar(), ïîñêîëüêó îíà åùå íå îïðåäåëåíà. */ foo(); /* Òåïåðü ìû ìîæåì âûçâàòü ôóíêöèþ bar(), îáðàáîòêà foo() ñäåëàëà åå äîñòóïíîé. */ bar(); ?> ]]> </programlisting> </example> </para> <simpara> PHP íå ïîääåðæèâàåò ïåðåãðóçêó ôóíêöèè, òàêæå îòñóòñòâóåò âîçìîæíîñòü ïåðåîïðåäåëèòü èëè óäàëèòü îáúÿâëåííóþ ðàíåå ôóíêöèþ. </simpara> <note> <simpara> Èìåíà ôóíêöèé ðåãèñòðîíåçàâèñèìû, òåì íå ìåíåå, áîëåå ïðåäïî÷òèòåëüíî âûçûâàòü ôóíêöèè òàê, êàê îíè áûëè îáúÿâëåíû. </simpara> </note> <simpara> PHP 3 íå ïîääåðæèâàåò ïåðåìåííîå êîëè÷åñòâî àðãóìåíòîâ ôóíêöèè, õîòÿ ïîääåðæêà çíà÷åíèé ïî óìîë÷àíèþ äëÿ àðãóìåíòîâ ïðèñóòñòâóåò (ñìîòðèòå ðàçäåë <link linkend="functions.arguments.default">Çíà÷åíèÿ àðãóìåíòîâ ïî óìîë÷àíèþ</link>). PHP 4 ïîääåðæèâàåò è òî, è äðóãîå: ñìîòðèòå ðàçäåë <link linkend="functions.variable-arg-list">Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû </link> è îïèñàíèÿ ôóíêöèé <function>func_num_args</function>, <function>func_get_arg</function>, è <function>func_get_args</function> äëÿ áîëåå äåòàëüíîé èíôîðìàöèè. </simpara> </sect1> <sect1 id="functions.arguments"> <title>Àðãóìåíòû ôóíêöèè</title> <simpara> Ôóíêöèÿ ìîæåò ïðèíèìàòü èíôîðìàöèþ â âèäå ñïèñêà àðãóìåíòîâ, êîòîðûé ÿâëÿåòñÿ ñïèñêîì ðàçäåëåííûõ çàïÿòûìè ïåðåìåííûõ è/èëè êîíñòàíò. </simpara> <para> PHP ïîääåðæèâàåò ïåðåäà÷ó àðãóìåíòîâ ïî çíà÷åíèþ (ïî óìîë÷àíèþ), <link linkend="functions.arguments.by-reference">ïåðåäà÷ó àðãóìåíòîâ ïî ññûëêå</link>, è <link linkend="functions.arguments.default">çíà÷åíèÿ ïî óìîë÷àíèþ</link>. Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû ïîääåðæèâàþòñÿ, íà÷èíàÿ ñ PHP 4: ñìîòðèòå ðàçäåë <link linkend="functions.variable-arg-list">Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû </link> è îïèñàíèÿ ôóíêöèé <function>func_num_args</function>, <function>func_get_arg</function> è <function>func_get_args</function> äëÿ áîëåå äåòàëüíîé èíôîðìàöèè. Ïîäîáíîãî ýôôåêòà ìîæíî äîñòè÷ü â PHP 3, ïåðåäàâàÿ ôóíêöèè ìàññèâ àðãóìåíòîâ: </para> <para> <example> <title>Ïåðåäà÷à ìàññèâà â ôóíêöèþ</title> <programlisting role="php"> <![CDATA[ <?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } ?> ]]> </programlisting> </example> </para> <sect2 id="functions.arguments.by-reference"> <title>Ïåðåäà÷à àðãóìåíòîâ ïî ññûëêå</title> <simpara> Ïî óìîë÷àíèþ àðãóìåíòû â ôóíêöèþ ïåðåäàþòñÿ ïî çíà÷åíèþ (ýòî îçíà÷àåò, ÷òî åñëè âû èçìåíèòå çíà÷åíèå àðãóìåíòà âíóòðè ôóíêöèè, òî âíå åå çíà÷åíèå âñå ðàâíî îñòàíåòñÿ ïðåæíèì). Åñëè âû õîòèòå ðàçðåøèòü ôóíêöèè ìîäèôèöèðîâàòü ñâîè àðãóìåíòû, âû äîëæíû ïåðåäàâàòü èõ ïî ññûëêå. </simpara> <para> Åñëè âû õîòèòå, ÷òî áû àðãóìåíò âñåãäà ïåðåäàâàëñÿ ïî ññûëêå, âû ìîæåòå óêàçàòü àìïåðñàíä (&) ïåðåä èìåíåì àðãóìåíòà â îïèñàíèè ôóíêöèè: </para> <para> <example> <title>Ïåðåäà÷à àðãóìåíòîâ ïî ññûëêå</title> <programlisting role="php"> <![CDATA[ <?php function add_some_extra(&$string) { $string .= 'and something extra.'; } $str = 'This is a string, '; add_some_extra($str); echo $str; // Âûâåäåò 'This is a string, and something extra.' ?> ]]> </programlisting> </example> </para> </sect2> <sect2 id="functions.arguments.default"> <title>Çíà÷åíèÿ àðãóìåíòîâ ïî óìîë÷àíèþ</title> <para> Ôóíêöèÿ ìîæåò îïðåäåëÿòü çíà÷åíèÿ ïî óìîë÷àíèþ â ñòèëå C++ äëÿ ñêàëÿðíûõ àðãóìåíòîâ, íàïðèìåð: </para> <para> <example> <title>Èñïîëüçîâàíèå çíà÷åíèé ïî óìîë÷àíèþ â îïðåäåëåíèè ôóíêöèè</title> <programlisting role="php"> <![CDATA[ <?php function makecoffee($type = "cappuccino") { return "Making a cup of $type.\n"; } echo makecoffee(); echo makecoffee("espresso"); ?> ]]> </programlisting> </example> </para> <para> Ðåçóëüòàò ðàáîòû ïðèâåäåííîãî âûøå êîäà áóäåò òàêèì: </para> <para> <screen> Making a cup of cappuccino. Making a cup of espresso. </screen> </para> <para> PHP òàêæå ïîçâîëÿåò èñïîëüçîâàòü ìàññèâû è ñïåöèàëüíûé òèï NULL â êà÷åñòâå çíà÷åíèé ïî óìîë÷àíèþ, íàïðèìåð: </para> <para> <example> <title>Èñïîëüçîâàíèå íåñêàëÿðíûõ òèïîâ â êà÷åñòâå çíà÷åíèé ïî óìîë÷àíèþ</title> <programlisting role="php"> <![CDATA[ <?php function makecoffee($types = array("cappuccino"), $coffeeMaker = NULL) { $device = is_null($coffeeMaker) ? "hands" : $coffeeMaker; return "Making a cup of ".join(", ", $types)." with $device.\n"; } echo makecoffee(); echo makecoffee(array("cappuccino", "lavazza"), "teapot"); ?> ]]> </programlisting> </example> </para> <simpara> Çíà÷åíèå ïî óìîë÷àíèþ äîëæíî áûòü êîíñòàíòíûì âûðàæåíèåì, à íå (ê ïðèìåðó) ïåðåìåííîé èëè âûçîâîì ôóíêöèè/ìåòîäà êëàññà. </simpara> <para> Îáðàòèòå âíèìàíèå, ÷òî âñå àðãóìåíòû, äëÿ êîòîðûõ óñòàíîâëåíû çíà÷åíèÿ ïî óìîë÷àíèþ, äîëæíû íàõîäèòñÿ ïðàâåå àðãóìåíòîâ, äëÿ êîòîðûõ çíà÷åíèÿ ïî óìîë÷àíèþ íå çàäàíû, â ïðîòèâíîì ñëó÷àå âàø êîä ìîæåò ðàáîòàòü íå òàê, êàê âû ýòîãî îæèäàåòå. Ðàññìîòðèì ñëåäóþùèé ïðèìåð: </para> <para> <example> <title>Íåêîððåêòíîå èñïîëüçîâàíèå çíà÷åíèé ïî óìîë÷àíèþ</title> <programlisting role="php"> <![CDATA[ <?php function makeyogurt($type = "acidophilus", $flavour) { return "Making a bowl of $type $flavour.\n"; } echo makeyogurt("raspberry"); // Íå áóäåò ðàáîòàòü òàê, êàê ìû ìîãëè áû îæèäàòü ?> ]]> </programlisting> </example> </para> <para> Ðåçóëüòàò ðàáîòû ïðèâåäåííîãî âûøå ïðèìåðà áóäåò ñëåäóþùèì: </para> <para> <screen> Warning: Missing argument 2 in call to makeyogurt() in /usr/local/etc/httpd/htdocs/php3test/functest.html on line 41 Making a bowl of raspberry . </screen> </para> <para> Òåïåðü ñðàâíèì ýãî ñî ñëåäóþùèì ïðèìåðîì: </para> <para> <example> <title>Íåêîððåêòíîå èñïîëüçîâàíèå çíà÷åíèé ïî óìîë÷àíèþ</title> <programlisting role="php"> <![CDATA[ <?php function makeyogurt($flavour, $type = "acidophilus") { return "Making a bowl of $type $flavour.\n"; } echo makeyogurt("raspberry"); // îòðàáàòûâàåò ïðàâèëüíî ?> ]]> </programlisting> </example> </para> <para> Òåïåðü ðåçóëüòàò ðàáîòû ïðèìåðà áóäåò âûãëÿäåòü òàê: </para> <para> <screen> Making a bowl of acidophilus raspberry. </screen> </para> </sect2> <sect2 id="functions.variable-arg-list"> <title>Ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû</title> <simpara> PHP 4 ïîääåðæèâàåò ñïèñêè àðãóìåíòîâ ïåðåìåííîé äëèíû äëÿ ôóíêöèé, îïðåäåëÿåìûõ ïîëüçîâàòåëåì. Ðåàëèçàöèÿ ýòîé âîçìîæíîñòè äîñòàòî÷íî ïðîçðà÷íà è çàêëþ÷àåòñÿ â èñïîëüçîâàíèè ôóíêöèé <function>func_num_args</function>, <function>func_get_arg</function> è <function>func_get_args</function>. </simpara> <simpara> Íåîáõîäèìîñòè â ñïåöèôè÷åñêîì ñèíòàêñèñå íåò, ïðè ýòîì ñïèñîê àðãóìåíòîâ òàêæå ìîæåò áûòü óêàçàí ÿâíî è áóäåò îáëàäàòü òåì æå ïîâåäåíèåì. </simpara> </sect2> </sect1> <sect1 id="functions.returning-values"> <title>Âîçâðàò çíà÷åíèé</title> <para> Çíà÷åíèÿ âîçâðàùàþòñÿ ïðè ïîìîùè íåîáÿçàòåëüíîãî îïåðàòîðà âîçâðàòà. Âîçâðàùàåìûå çíà÷åíèÿ ìîãóò áûòü ëþáîãî òèïà, â òîì ÷èñëå ýòî ìîãóò áûòü ñïèñêè è îáúåêòû. Âîçâðàò ïðèâîäèò ê çàâåðøåíèþ âûïîëíåíèÿ ôóíêöèè è ïåðåäà÷å óïðàâëåíèÿ îáðàòíî ê òîé ñòðîêå êîäà, â êîòîðîé äàííàÿ ôóíêöèÿ áûëà âûçâàíà. Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè îçíàêîìüòåñü ñ îïèñàíèåì ôóíêöèè <function>return</function>. </para> <para> <example> <title>Èñïîëüçîâàíèå ôóíêöèè <function>return</function></title> <programlisting role="php"> <![CDATA[ <?php function square($num) { return $num * $num; } echo square(4); // âûâîäèò '16'. ?> ]]> </programlisting> </example> </para> <para> Ôóíêöèÿ íå ìîæåò âîçâðàùàòü íåñêîëüêî çíà÷åíèé, íî àíàëîãè÷íîãî ðåçóëüòàòà ìîæíî äîáèòüñÿ, âîçâðàùàÿ ìàññèâ. </para> <para> <example> <title>Âîçâðàò íåñêîëüêèõ çíà÷åíèé â âèäå ìàññèâà</title> <programlisting role="php"> <![CDATA[ <?php function small_numbers() { return array (0, 1, 2); } list ($zero, $one, $two) = small_numbers(); ?> ]]> </programlisting> </example> </para> <para> Äëÿ òîãî, ÷òîáû ôóíêöèÿ âîçâðàùàëà ðåçóëüòàò ïî ññûëêå, âàì íåîáõîäèìî èñïîëüçîâàòü îïåðàòîð & è ïðè îïèñàíèè ôóíêöèè, è ïðè ïðèñâîåíèè ïåðåìåííîé âîçâðàùàåìîãî çíà÷åíèÿ: </para> <para> <example> <title>Âîçâðàò ðåçóëüòàòà ïî ññûëêå</title> <programlisting role="php"> <![CDATA[ <?php function &returns_reference() { return $someref; } $newref =& returns_reference(); ?> ]]> </programlisting> </example> </para> <simpara> Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè î ññûëêàõ îáðàòèòåñü ê ðàçäåëó äîêóìåíòàöèè <link linkend="language.references">Ïîäðîáíî îá óêàçàòåëÿõ</link>. </simpara> </sect1> <sect1 id="functions.variable-functions"> <title>Îáðàùåíèå ê ôóíêöèÿì ÷åðåç ïåðåìåííûå</title> <para> PHP ïîääåðæèâàåò êîíöåïöèþ ïåðåìåííûõ ôóíêöèé. Ýòî îçíà÷àåò, ÷òî åñëè ê èìåíè ïåðåìåííîé ïðèñîåäèíåíû êðóãëûå ñêîáêè, PHP èùåò ôóíêöèþ ñ òåì æå èìåíåì, ÷òî è ðåçóëüòàò âû÷èñëåíèÿ ïåðåìåííîé, è ïûòàåòñÿ åå âûïîëíèòü. Ýòó âîçìîæíîñòü ìîæíî èñïîëüçîâàòü äëÿ ðåàëèçàöèè îáðàòíûõ âûçîâîâ, òàáëèö ôóíêöèé è ìíîæåñòâà äðóãèõ âåùåé. </para> <para> Ïåðåìåííûå ôóíêöèè íå áóäóò ðàáîòàòü ñ òàêèìè ÿçûêîâûìè êîíñòðóêöèÿìè êàê <function>echo</function>, <function>print</function>, <function>unset</function>, <function>isset</function>, <function>empty</function>, <function>include</function>, <function>require</function> è äðóãèìè ïîäîáíûìè èì îïåðàòîðàìè. Âàì íåîáõîäèìî ðåàëèçîâûâàòü ñâîþ ôóíêöèþ-îáåðòêó (wrapper) äëÿ òîãî, ÷òîáû ïðèâåäåííûå âûøå êîíñòðóêöèè ìîãëè ðàáîòàòü ñ ïåðåìåííûìè ôóíêöèÿìè. </para> <para> <example> <title>Ðàáîòà ñ ôóíêöèÿìè ïîñðåäñòâîì ïåðåìåííûõ</title> <programlisting role="php"> <![CDATA[ <?php function foo() { echo "In foo()<br />\n"; } function bar($arg = '') { echo "In bar(); argument was '$arg'.<br />\n"; } // Ôóíêöèÿ-îáåðòêà äëÿ echo function echoit($string) { echo $string; } $func = 'foo'; $func(); // Âûçûâàåò ôóíêöèþ foo() $func = 'bar'; $func('test'); // Âûçûâàåò ôóíêöèþ bar() $func = 'echoit'; $func('test'); // Âûçûûâåò ôóíêöèþ echoit() ?> ]]> </programlisting> </example> </para> <para> Âû òàêæå ìîæåòå âûçâàòü ìåòîäû îáúåêòà, èñïîëüçóÿ âîçìîæíîñòè PHP äëÿ ðàáîòû ñ ïåðåìåííûìè ôóíêöèÿìè. <example> <title>Îáðàùåíèå ê ìåòîäàì êëàññà ïîñðåäñòâîì ïåðåìåííûõ</title> <programlisting role="php"> <![CDATA[ <?php class Foo { function Variable() { $name = 'Bar'; $this->$name(); // Âûçûâàåì ìåòîä Bar() } function Bar() { echo "This is Bar"; } } $foo = new Foo(); $funcname = "Variable"; $foo->$funcname(); // Îáðàùàåìñÿ ê $foo->Variable() ?> ]]> </programlisting> </example> </para> <para> Ñìîòðèòå òàêæå <function>call_user_func</function>, <link linkend="language.variables.variable">Ïåðåìåííûå ïåðåìåííûå</link> è <function>function_exists</function>. </para> </sect1> <sect1 id="functions.internal"> <title>Âñòðîåííûå ôóíêöèè</title> <para>  ñàìîì PHP ñîäåðæèòñÿ äîñòàòî÷íî áîëüøîå êîëè÷åñòâî âñòðîåííûõ ôóíêöèé è ÿçûêîâûõ êîíñòðóêöèé. Òàêæå åñòü ôóíêöèè, êîòîðûå òðåáóþò, ÷òîáû PHP áûë ñîáðàí ñî ñïåöèôè÷åñêèìè ðàñøèðåíèÿìè, â ïðîòèâíîì ñëó÷àå âû ïîëó÷èòå ñîîáùåíèå îá îøèáêå, âûçâàííîé èñïîëüçîâàíèåì íåèçâåñòíîé ôóíêöèè. Íàïðèìåð, äëÿ òîãî ÷òîáû èñïîëüçîâàòü <link linkend="ref.image">Ôóíêöèè äëÿ ðàáîòû ñ èçîáðàæåíèÿìè</link>, íàïðèìåð <function>imagecreatetruecolor</function>, âàì íåîáõîäèìî ñîáðàòü PHP ñ ïîääåðæêîé <productname>GD</productname>. Èëè æå äëÿ òîãî, ÷òîáû âîñïîëüçîâàòüñÿ ôóíêöèåé <function>mysql_connect</function>, âàì íåîáõîäèìà ïîääåðæêà ìîäóëÿ <link linkend="ref.mysql">MySQL</link>. Òåì íå ìåíåå, åñòü ìíîãî âñòðîåííûõ ôóíêöèé, êîòîðûå äîñòóïíû âñåãäà: íàïðèìåð <link linkend="ref.strings">Ôóíêöèè îáðàáîòêè ñòðîê</link> è <link linkend="ref.var">Ôóíêöèè äëÿ ðàáîòû ñ ïåðåìåííûìè</link>. Âûçâàâ <function>phpinfo</function> èëè <function>get_loaded_extensions</function>, âû ìîæåòå óçíàòü, ïîääåðæêà êàêèõ ìîäóëåé åñòü â èñïîëüçóåìîì âàìè PHP. Òàêæå ñëåäóåò ó÷åñòü, ÷òî ïîääåðæêà íåêîòîðûõ äîïîëíèòåëüíûõ ðàñøèðåíèé âêëþ÷åíà ïî óìîë÷àíèþ, è ÷òî ñàìà äîêóìåíòàöèÿ ê PHP ðàçáèòà ïî ðàñøèðåíèÿì. Îçíàêîìüòåñü ñ ðàçäåëàìè <link linkend="configuration">Êîíôèãóðàöèÿ</link>, <link linkend="installation">Óñòàíîâêà</link>, à òàêæå ñ äîêóìåíòàöèåé íåïîñðåäñòâåííî ê äîïîëíèòåëüíûì ðàñøèðåíèÿì äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè î òîì, êàê íàñòðîèòü âàø PHP. </para> <para> Áîëåå ïîäðîáíóþ èíôîðìàöèþ î òîì, êàê ñëåäóåò ÷èòàòü è èíòåðïðåòèðîâàòü ïðîòîòèïû ôóíêöèé, âû ìîæåòå íàéòè â ðàçäåëå <link linkend="about.prototypes">Êàê ïðàâèëüíî ÷èòàòü îïèñàíèÿ ôóíêöèé</link>. Î÷åíü âàæíî ïîíèìàòü, ÷òî âîçâðàùàåò ôóíêöèÿ, èëè êàê èìåííî îíà ìîäèôèöèðóåò ïåðåäàâàåìûå àðãóìåíòû. Íàïðèìåð, ôóíêöèÿ <function>str_replace</function> âîçâðàùàåò ìîäèôèöèðîâàííóþ ñòðîêó, â òî âðåìÿ êàê ôóíêöèÿ <function>usort</function> ðàáîòàåò ñ ôàêòè÷åñêè ïåðåäàííîé ïåðåìåííîé. Êàæäàÿ ñòðàíèöà äîêóìåíòàöèè òàêæå ñîäåðæèò èíôîðìàöèþ, êîòîðàÿ ñïåöèôè÷íà äëÿ äàííîé ôóíêöèè, íàïðèìåð, èíôîðìàöèþ î ïåðåäàâàåìûõ ïàðàìåòðàõ, èçìåíåíèÿõ â ïîâåäåíèè, âîçâðàùàåìûõ çíà÷åíèÿõ â ñëó÷àå êàê óäà÷íîãî, òàê è íåóäà÷íîãî âûïîëíåíèÿ, äîñòóïíîñòè ôóíêöèè â ðàçëè÷íûõ âåðñèÿõ. Çíàíèå è ïðèìåíåíèå ýòèõ (ïîðîé äàæå íåçàìåòíûõ) íþàíñîâ î÷åíü âàæíî äëÿ íàïèñàíèÿ êîððåêòíîãî PHP-êîäà. </para> <para> Îçíàêîìüòåñü òàêæå ñî <link linkend="funcref">Ñïðàâî÷íèêîì ôóíêöèé</link> è áîëåå äåòàëüíûìè îïèñàíèÿìè ôóíêöèé <function>function_exists</function>, <function>get_extension_funcs</function> è <function>dl</function>. </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->