archived-doc-pl/reference/array/functions/array-walk.xml

<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.25 Maintainer: leszek Status: ready -->
<!-- $Revision: 1.5 $ -->
  <refentry id="function.array-walk">
   <refnamediv>
    <refname>array_walk</refname>
    <refpurpose>
     Zastosuj funkcjê u¿ytkownika do ka¿dego elementu tablicy
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>array_walk</methodname>
      <methodparam><type>array</type><parameter role="reference">tablica</parameter></methodparam>
      <methodparam><type>callback</type><parameter>nazwa_funkcji</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>dane</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     &return.success;
    </simpara>
    <simpara>
     Wykonuje zdefiniowan± przez u¿ytkownika funkcjê
     <parameter>nazwa_funkcji</parameter> na ka¿dym elemencie tablicy
     <parameter>tablica</parameter>. Zazwyczaj <parameter>nazwa_funkcji</parameter>
     przyjmuje dwa argumenty. Pierwszym jest element tablicy
     <parameter>tablica</parameter>, natomiast drugim klucz lub numer indeksu
     tego elementu. Je¶li do funkcji <function>array_walk</function> podany
     zostanie trzeci element, <parameter>dane</parameter>, bêdzie on
     przekazany do <parameter>nazwa_funkcji</parameter> jako jej trzeci
     argument.
    </simpara>
    <simpara>
     Je¶li <parameter>nazwa_funkcji</parameter> wymaga wiêcej parametrów ni¿ zosta³o
     jej przekazanych, wygenerowany zostanie b³±d poziomu <link
      linkend="errorfunc.constants">E_WARNING</link> dla ka¿dego wywo³ania
     funkcji podanej jako parametr. Ostrze¿enia te mog± byæ wyciszone poprzez
     skorzystanie z operatora kontroli b³êdów <link
      linkend="language.operators.errorcontrol">@</link> przed wywo³aniem
     <function>array_walk</function>, lub te¿ poprzez u¿ycie funkcji
     <function>error_reporting</function>.
    </simpara>
    <note>
     <para>
      Je¶li <parameter>nazwa_funkcji</parameter> ma zmieniaæ warto¶ci tablicy,
      nale¿y okre¶liæ pierwszy argument <parameter>nazwa_funkcji</parameter>
      jako <link linkend="language.references">referencjê</link>. W tym
      przypadku wszystkie zmiany dokonane przez t± funkcjê bêd± dokonywane
      bezpo¶rednio na oryginalnej tablicy.
     </para>
    </note>
    <note>
     <para>
      Przekazywanie klucza i danych u¿ytkownika do <parameter>nazwa_funkcji</parameter>
      zosta³o dodane w PHP 4.0.0.
     </para>
    </note>
    <para>
     Na dzia³anie <function>array_walk</function> nie wp³ywa pozycja
     wewnêtrznego wska¼nika tablicy. <function>array_walk</function>
     przetworzy wszystkie elementy argumentu <parameter>tablica</parameter>,
     niezale¿nie odpozycji jej wewnêtrznego wska¼nika.
    </para>
    <para>
     U¿ytkownicy nie mog± zmieniaæ samej tablicy z wnêtrza funkcji zwrotnej,
     to jest dodawaæ/usuwaæ elementy, usuwaæ elementy tablicy na której jest
     wywo³ywana funkcja <function>array_walk</function>. Je¶li ta tablica
     zostanie zmieniona, funkcja mo¿e siê zachowywaæ w sposób nieokre¶lony i
     nieprzewidywalny..
    </para>
    <para>
     <example>
      <title>Przyk³ad u¿ycia <function>array_walk</function></title>
      <programlisting role="php">
<![CDATA[
<?php
$owoce = array ("d"=>"cytryna", "a"=>"pomarañcza", "b"=>"banan", "c"=>"jab³ko");

function test_zmiana (&$element1, $klucz, $prefiks)
{
    $element1 = "$prefiks: $element1";
}

function test_wyswietlanie ($element2, $klucz)
{
    echo "$klucz. $element2<br />\n";
}

echo "Przed ...:\n";
array_walk ($owoce, 'test_wyswietlanie');

array_walk ($owoce, 'test_zmiana', 'owoc');
echo "... i po:\n";

array_walk ($owoce, 'test_wyswietlanie');
?>
]]>
      </programlisting>
      &example.outputs;
      <screen>
<![CDATA[
Przed ...:
d. cytryna
a. pomarañcza
b. banan
c. jab³ko
... i po:
d. owoc: cytryna
a. owoc: pomarañcza
b. owoc: banan
c. owoc: jab³ko
]]>
      </screen>
     </example>
    </para>
    <simpara>
     Patrz tak¿e: 
     <function>array_walk_recursive</function>,
     <function>create_function</function>,
     <function>list</function>,
     <link linkend="control-structures.foreach">foreach</link>,
     <function>each</function>,
     <function>call_user_func_array</function>, and
     <function>array_map</function> i
     &seealso.callback;.
    </simpara>
   </refsect1>
  </refentry>

<!-- 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
-->