<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.18 Maintainer: leon Status: ready -->
<!-- $Revision: 1.7 $ -->
 <chapter id="functions">
  <title>Funkcje</title>

  <sect1 id="functions.user-defined">
   <title>Funkcje zdefiniowane przez uytkownika</title>
 
   <para>
    Funkcja moe by zdefiniowana uywajc skadni takiej jak ponisza:
 
    <informalexample>
     <programlisting role="php">
<![CDATA[
function foo ($arg_1, $arg_2, ..., $arg_n)
{
    echo "Przykadowa funkcja.\n";
    return $retval;
}
]]>
     </programlisting>
    </informalexample>
   </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>
    Dowolny poprawny kod PHP moe si pojawi wewntrz funkcji, take
    definicje innych funkcji i  <link linkend="keyword.class">klas</link>.
   </simpara>
   <simpara>
    W PHP 3, funkcje musz by zdefiniowane przed odwoaniem do nich. W PHP 4
    nie ma takiego wymagania.
   </simpara>
   <simpara>
    PHP nie obsuguje przeciania funkcji. Nie jest take moliwa
    od-definiowanie lub przedefiniowanie wczeniej zadeklarowanych funkcji.
   </simpara>
   <simpara>
    PHP 3 nie obsuguje funkcji o zmiennej liczbie argumentw, ale obsuguje
    domylne argumenty (zobacz rozdzial <link
    linkend="functions.arguments.default">Wartoci domylne argumentw
    </link> aby uzyska wicej informacji). PHP 4 obsuguje jedne i drugie:
    zobacz <link
    linkend="functions.variable-arg-list">Listy argumentw o zmiennej dugoci
    </link> i opisy funkcji
    <function>func_num_args</function>,
    <function>func_get_arg</function>, i
    <function>func_get_args</function> aby uzyska wicej informacji.
   </simpara>

  </sect1>
 
  <sect1 id="functions.arguments">
   <title>Argumenty funkcji</title>
 
   <simpara>
    Informacje mog by przekazywane do funkcji przez list argumentw, ktra
    jest separowan przecinkami list zmiennych i/lub staych.
   </simpara> 
   <para>
     PHP obsuguje przekazywanie argumentw przez warto (domylnie), 
     <link linkend="functions.arguments.by-reference">przez referencj </link>,
     i <link linkend="functions.arguments.default">wartoci domylne
     argumentw</link>. Listy argumentw o zmiennej dugoci s obsugiwane
     tylko w PHP 4 i nowszych; zobacz rozdzia <link
     linkend="functions.variable-arg-list">Listy argumentw o zmiennej
     dugoci</link> i opisy funkcji
     <function>func_num_args</function>,
     <function>func_get_arg</function>, i
     <function>func_get_args</function> aby uzyska wicej informacji. Podobny
     efekt moe by uzyskany w PHP 3 przez przekazywanie tablicy argumentw do
     funkcji:
 
    <informalexample>
     <programlisting role="php">
<![CDATA[
function pobiera_tablice($wejscie)
{
    echo "$wejscie[0] + $wejscie[1] = ", $wejscie[0]+$wejscie[1];
}
]]>
     </programlisting>
    </informalexample>
   </para>
 
   <sect2 id="functions.arguments.by-reference">
    <title>Przekazywanie argumentw przez referencj</title>
 
    <simpara>
     Domylnie, argumenty funkcji s przekazywane przez warto (a wic jeli
     zmienisz warto argumentu wewntrz funkcji, nie zmieni si ona poza
     funkcj). Jeli chcesz pozwoli funkcji na modyfikacj swoich argumentw,
     musisz przekaza je przez referencj.
    </simpara>
    <para>
     Jeli chcesz, aby argumenty byy zawsze przekazywane przez referencj,
     przed nazw zmiennej w definicji funkcji wstaw znak ampersand (&amp;):
 
     <informalexample>
      <programlisting role="php">
<![CDATA[
function dodaj_cos_extra(&$string)
{
    $string .= 'i co extra.';
}
$str = 'To jest string, ';
dodaj_cos_extra($str);
echo $str;    // wywietla 'To jest string string, i co extra.'
]]>
      </programlisting>
     </informalexample>
    </para>
 
    <para>
     Jeli chcesz przekaza zmienn przez referencj do funkcji, ktra tego
     domylnie tego nie robi, moesz wstawi ampersand przez nazw argumentu
     przy wywoaniu funkcji:
 
     <informalexample>
      <programlisting role="php">
<![CDATA[
function foo ($bar)
{
    $bar .= ' i co ekstra.';
}
$str = 'To jest string, ';
foo ($str);
echo $str;    // wywietla 'To jest string, '
foo (&$str);
echo $str;    // wywietla 'To jest string, i co extra.'
]]>
      </programlisting>
     </informalexample>
    </para>

   </sect2>
 
   <sect2 id="functions.arguments.default">
    <title>Wartoci domylne argumentw</title>
 
    <para>
     Funkcja moe definiowa, podobnie jest w C++,  wartoci domylne dla
     argumentw skalarnych:
 
     <informalexample>
      <programlisting role="php">
<![CDATA[
function robkawe ($typ = "cappucino")
{
    return "Robi kubek $type.\n";
}
echo robkawe ();
echo robkawe ("espresso");
]]>
      </programlisting>
     </informalexample>
    </para>
 
    <para>
     Powyszy kawaek kody wywietli:
 
     <screen>
Robi kubek cappucino.
Robi kubek espresso.
     </screen>
    </para>
 
    <simpara>
     Domylna warto musi by staym wyraeniem, nie (na przykad) zmienn
     lub czonkiem klasy.
    </simpara>
    <para>
     Zauwa, e uywajc domylnych argumentw, argumenty zawierajce wartoci
     domylne powinny by po prawej stronie tych nie zawierajcych wartoci
     domylnych; w przeciwnym przypadku funkcja moe nie dziaa tak jak si
     tego spodziewae. Zobacz to na poniszym przykadzie:
 
     <informalexample>
      <programlisting role="php">
<![CDATA[
function robjogurt ($typ = "acidophilus", $smak)
{
    return "Robi misk $typ $smak.\n";
}
 
echo robjogurt ("malinowy");   // nie dziaa tak jak si spodziewalimy
]]>
      </programlisting>
     </informalexample>
    </para>
 
    <para>
     Powysza funkcja wywietla:
 
     <screen>
Warning: Missing argument 2 in call to robjogurt() in 
/usr/local/etc/httpd/htdocs/php3test/functest.html on line 41
Robi misk malinowy .
     </screen>
    </para>
 
    <para>
     Porwnaj powyszy przykad z tym:
 
     <informalexample>
      <programlisting role="php">
<![CDATA[
function robjogurt ($smak, $typ = "acidophilus")
{
    return "Robi misk $type $flavour.\n";
}
 
echo robjogurt ("malinowy");   // dziaa tak jak si spodziewalimy
]]>
      </programlisting>
     </informalexample>
    </para>
 
    <para>
     Powyszy kod wywietla:
 
     <screen>
Robi misk acidophilus malinowy.
     </screen>
    </para>

   </sect2>

   <sect2 id="functions.variable-arg-list">
    <title>Listy argumentw o zmiennej dugoci</title>
	
    <simpara>
     PHP 4 obsuguje listy o zmiennej dugoci w funkcjach zdefiniowanych
     przez uytkownika. Jest naprawd prost przy uyciu funkcji
     <function>func_num_args</function>,
     <function>func_get_arg</function> i
     <function>func_get_args</function>.
    </simpara>

    <simpara>
     Nie wymagana jest adna specjalna skadnia. Listy argumentw mog by
     cigle jawnie podane przy definicji funkcji i bd si zachowywa
     normalnie.
    </simpara>

   </sect2>

  </sect1>
 
  <sect1 id="functions.returning-values">
   <title>Zwracane wartoci</title>
 
   <para>
    Wartoci s zwracana przy uyciu opcjonalnej instrukcji return. Moe by
    zwracany dowonlny typ, wczajc w to tablice i obiekty.
 
    <informalexample>
     <programlisting role="php">
<![CDATA[
function kwadrat ($num)
{
    return $num * $num;
}
echo kwadrat (4);   // wywietla '16'.
]]>
     </programlisting>
    </informalexample>
   </para>
      
   <para>
    Nie moesz zwraca zwraca wielu wartoci z funkcji, ale podobne efekty
    mog by uzyskane przez zwracanie listy.
 
    <informalexample>
     <programlisting role="php">
<![CDATA[
function maleLiczby()
{
    return array (0, 1, 2);
}
list ($zero, $jeden, $dwa) = maleLiczby();
]]>
     </programlisting>
    </informalexample>
   </para>
   <para>
    Aby funkcja zwracaa referencj, musisz uy operatora referencji &amp; i
    w deklaracji funkcji i przy przypisywaniu zwracanej wartoci do zmiennej:
    <informalexample>
     <programlisting role="php">
<![CDATA[
function &zwrocReferencje()
{
    return $jakasref;
}

$nowaref =& zwrocReferencje();
]]>
     </programlisting>
    </informalexample>
   </para>

  </sect1>
 
  <sect1 id="functions.old-syntax">
   <title><literal>old_function</literal></title>
 
   <simpara>
    Instrukcja <literal>old_function</literal> pozwala na zadeklarowanie
    funkcji korzystajc ze skadni takiej samej jak w PHP/FI2 (tylko e
    zamiast 'function' musisz uy 'old_function'.
   </simpara>
   <simpara>
    Jest to niezalecana opcja i powinna by uywana tylko przez konwerter
    PHP/FI2->PHP 3.
   </simpara>
   <warning>
    <para>
     Funkcje zadekladowane jako <literal>old_function</literal> nie mog by
     wywoane z kodu wewntrznego PHP. Midzy innymi oznacza to, e nie moesz
     uywa ich z takich funkcji jak <function>usort</function>,
     <function>array_walk</function> i <function>register_shutdown_function
     </function>. Moesz obej to ograniczenie przez napisanie interfejsu (w
     normalnej dla PHP 3 postaci) wywoujcego <literal>old_function</literal>.
    </para>
   </warning>

  </sect1>

  <sect1 id="functions.variable-functions">
   <title>Zmienne funkcje</title>

   <para>
    PHP obsuguje koncepcj zmiennych funkcji. Oznacza to, e jeli po nazwie
    zmiennej wystpuj nawiasy, PHP bdzie szukao funkcji o nazwie bdcej
    wartoci zmiennej i bdzie prbowao wywoa j. Midzy innymi moe by
    to uyte do implementacji funkcji callback, tablicy funkcji itp.
   </para>
   <para>
    Zmienne funkcje nie bd dziaa z elementami skadowymi jzyka, takimi
    jak <function>echo</function>, <function>unset</function>,
    <function>isset</function> i <function>empty</function>. Jest to jedna z
    gwnych rnic pomidzy funkcjami PHP i elementami skadowymi jzyka.
   </para>
   <para>
    <example>
     <title>Przykad zmiennej funkcji</title>
     <programlisting role="php">
<![CDATA[
<?php
function foo()
{
    echo "W foo()<br>\n";
}

function bar($arg = '')
{
    echo "W bar(); argumentem jest '$arg'.<br>\n";
}

$func = 'foo';
$func();
$func = 'bar';
$func('test');
?>
]]>
     </programlisting>
    </example>
   </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
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
-->