cvs: phpdoc-pl /reference/array/functions extract.xml
| From: | Leszek Krupinski | Date: | Thu, 24 Feb 2005 01:03:42 +0000 |
| Subject: | cvs: phpdoc-pl /reference/array/functions extract.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-437@lists.php.net to get a copy of this message | ||
leszek Wed Feb 23 20:03:42 2005 EDT
Modified files:
/phpdoc-pl/reference/array/functions extract.xml
Log:
[leszek] - updated to 1.18
http://cvs.php.net/diff.php/phpdoc-pl/reference/array/functions/extract.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-pl/reference/array/functions/extract.xml diff -u phpdoc-pl/reference/array/functions/extract.xml:1.4 phpdoc-pl/reference/array/functions/extract.xml:1.5 --- phpdoc-pl/reference/array/functions/extract.xml:1.4 Fri May 17 09:50:48 2002 +++ phpdoc-pl/reference/array/functions/extract.xml Wed Feb 23 20:03:41 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.4 Maintainer: leszek Status: ready --> -<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.18 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.5 $ --> <refentry id="function.extract"> <refnamediv> <refname>extract</refname> @@ -27,12 +27,18 @@ </para> <note> <para> - Od wersji 4.0.5 ta funkcja zwraca liczbê wyekstraktowanych zmiennych. + Od wersji 4.0.5 ta funkcja zwraca liczbê wyekstrahowanych zmiennych. </para> </note> <note> <para> - Sta³e EXTR_IF_EXISTS i EXTR_PREFIX_IF_EXISTS zosta³y dodane w PHP 4.2.0. + Sta³e <constant>EXTR_IF_EXISTS</constant> i + <constant>EXTR_PREFIX_IF_EXISTS</constant> zosta³y dodane w PHP 4.2.0. + </para> + </note> + <note> + <para> + Sta³a <constant>EXTR_REFS</constant> zosta³a dodana w PHP 4.3.0. </para> </note> <para> @@ -44,7 +50,7 @@ warto¶ci: <variablelist> <varlistentry> - <term>EXTR_OVERWRITE</term> + <term><constant>EXTR_OVERWRITE</term></constant> <listitem> <simpara> Je¶li istnieje kolizja, nadpisz istniej±c± zmienn±. @@ -52,7 +58,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_SKIP</term> + <term><constant>EXTR_SKIP</term></constant> <listitem> <simpara> Je¶li istnieje kolizja, nie nadpisuj istniej±cej zmiennej. @@ -60,7 +66,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_SAME</term> + <term><constant>EXTR_PREFIX_SAME</term></constant> <listitem> <simpara> Je¶li istnieje kolizja, na pocz±tek nazwy zmiennej wstaw @@ -69,7 +75,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_ALL</term> + <term><constant>EXTR_PREFIX_ALL</term></constant> <listitem> <simpara> Na pocz±tek ka¿dej nazwy zmiennej wstaw <parameter>prefiks</parameter>. @@ -78,7 +84,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_INVALID</term> + <term><constant>EXTR_PREFIX_INVALID</term></constant> <listitem> <simpara> Wstaw <parameter>prefiks</parameter> na pocz±tek z³ych/numerycznych @@ -87,18 +93,18 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_IF_EXISTS</term> + <term><constant>EXTR_IF_EXISTS</term></constant> <listitem> <simpara> Nadpisz tylko zmienn± ju¿ istniej±c± w bie¿±cej tablicy symboli. Jest - to przydatne do definiowania listy poprawnych zmiennych i ekstraktuj + to przydatne do definiowania listy poprawnych zmiennych i ekstrahuj tylko te zmienne które zdefiniowano na przyk³ad w $_REQUEST. Flaga ta zosta³a dodana w PHP 4.2.0. </simpara> </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_IF_EXISTS</term> + <term><constant>EXTR_PREFIX_IF_EXISTS</term></constant> <listitem> <simpara> Przedrostek zostanie dodany tylko do zmiennych których odpowiedniki @@ -107,25 +113,56 @@ </simpara> </listitem> </varlistentry> + <varlistentry> + <term><constant>EXTR_REFS</constant></term> + <listitem> + <simpara> + Ekstraktuje zmienne jako referencje. Oznacza to, ¿e warto¶ci + zaimportowanych zmiennych ci±gle odnosz± siê do warto¶ci parametru + <parameter>tablica_zmiennych</parameter>. Flaga ta mo¿e byæ u¿yta + sama lub w po³±czaniu z innymi flagami poprzez u¿ycie operacji OR na + parametrze <parameter>typ_ekstrakcji</parameter>. Zosta³a ona dodana + w PHP 4.3.0. + </simpara> + </listitem> + </varlistentry> </variablelist> </para> <para> Je¶li <parameter>typ_ekstrakcji</parameter> nie zosta³ podany, to - zak³adana jest opcja EXTR_OVERWRITE. + zak³adana jest opcja <constant>EXTR_OVERWRITE</constant>. </para> <para> Zauwa¿, ¿e parametr <parameter>prefiks</parameter> jest wymagany tylko - je¶li <parameter>typ_ekstrakcji</parameter> to EXTR_PREFIX_SAME, - EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID lub EXTR_PREFIX_IF_EXISTS. Je¶li - nazwa zmiennej po dodaniu prefiksu nie jest prawid³ow± nazw± zmiennej, - nie jest importowana do tablicy symboli. + je¶li <parameter>typ_ekstrakcji</parameter> to + <constant>EXTR_PREFIX_SAME</constant>, + <constant>EXTR_PREFIX_ALL</constant>, + <constant>EXTR_PREFIX_INVALID<constant> lub + <constant>EXTR_PREFIX_IF_EXISTS</constant>. Je¶li nazwa zmiennej po + dodaniu prefiksu nie jest prawid³ow± nazw± zmiennej, nie jest + importowana do tablicy symboli. </para> <para> <function>extract</function> zwraca liczbê zmiennych szczê¶liwie zaimportowanych do tablicy symboli. </para> + <warning> + <para> + Nie nale¿y u¿ywaæ funkcji <function>extract</function> na niepewnych + danych, jak na przyk³ad danych odebranych od u¿ytkownika ($_GET, ...). + Mo¿na tak zrobiæ na przyk³ad w celu tymczasowego uruchomienia starych + skryptów, które zale¿ne s± od ustawienia <link + linkend="security.globals">register_globals</link>. Nale¿y jednak u¿yæ + nie nadpisuj±cego parametru <parameter>typ_ekstrakcji</parameter>, jak + na przyk³ad <constant>EXTR_SKIP</constant>. Trzeba te¿ pamiêtaæ aby + ekstrahowaæ zmienne <varname>$_SERVER</varname>, + <varname>$_SESSION</varname>, <varname>$_COOKIE</varname>, + <varname>$_POST</varname> <varname>$_GET</varname> w tej w³a¶nie + kolejno¶ci. + </para> + </warning> <para> - Mo¿liwy jest import zmiennych zawartych w tablicy asocjacyjnej zwróconej + Mo¿liwa jest ekstrakcja zmiennych zawartych w tablicy asocjacyjnej zwróconej przez <function>wddx_deserialize</function>. </para> <para> @@ -139,41 +176,40 @@ wddx_deserialize */ $rozmiar = "du¿y"; -$tablica_zmiennych = array ("kolor" => "niebieski", - "rozmiar" => "¶redni", - "ksztalt" => "kulisty"); -extract ($tablica_zmiennych, EXTR_PREFIX_SAME, "wddx"); +$tablica_zmiennych = array("kolor" => "niebieski", + "rozmiar" => "¶redni", + "ksztalt" => "kulisty"); +extract($tablica_zmiennych, EXTR_PREFIX_SAME, "wddx"); -print "$kolor, $rozmiar, $ksztalt, $wddx_rozmiar\n"; +echo "$kolor, $rozmiar, $ksztalt, $wddx_rozmiar\n"; ?> ]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad wy¶wietli: - <programlisting> + <screen> <![CDATA[ niebieski, du¿y, kulisty, ¶redni ]]> - </programlisting> + </screen> + </example> </para> <para> <varname>$rozmiar</varname> nie zosta³ nadpisany, poniewa¿ podany zosta³ - parametr EXTR_PREFIX_SAME, przez co stworzona zosta³ zmienna - <varname>$wddx_rozmiar</varname>. Je¶li podana by by³a flaga EXTR_SKIP, - to zmienna <varname>$wddx_rozmiar</varname> nie zosta³aby stworzona. - Flaga EXTR_OVERWRITE spowodowa³aby, ¿e zmienna <varname>$rozmiar</varname> - mia³aby warto¶æ "¶redni", a EXTR_PREFIX_ALL spowodowa³aby ¿e wszystkie - nowe zmienne zosta³yby nazwane <varname>$wddx_kolor</varname>, - <varname>$wddx_rozmiar</varname>, and - <varname>$wddx_ksztalt</varname>. + parametr <constant>EXTR_PREFIX_SAME</constant>, przez co stworzona zosta³ + zmienna <varname>$wddx_rozmiar</varname>. Je¶li podana by by³a flaga + <constant>EXTR_SKIP</constant>, to zmienna + <varname>$wddx_rozmiar</varname> nie zosta³aby stworzona. Flaga + <constant>EXTR_OVERWRITE</constant> spowodowa³aby, ¿e zmienna + <varname>$rozmiar</varname> mia³aby warto¶æ "¶redni", a + <constant>EXTR_PREFIX_ALL</constant> spowodowa³aby ¿e wszystkie nowe + zmienne zosta³yby nazwane <varname>$wddx_kolor</varname>, + <varname>$wddx_rozmiar</varname>, and <varname>$wddx_ksztalt</varname>. </para> <para> Musisz u¿yæ tablic asocjacyjnych. Tablica indeksowana liczbowo nie da - ¿adnych efektów, chyba ¿e zostanie u¿yta flaga EXTR_PREFIX_ALL lub - EXTR_PREFIX_INVALID. + ¿adnych efektów, chyba ¿e zostanie u¿yta flaga + <constant>EXTR_PREFIX_ALL</constant> lub + <constant>EXTR_PREFIX_INVALID</constant>. </para> <para> Patrz tak¿e: <function>compact</function>.
http://cvs.php.net/diff.php/phpdoc-pl/reference/array/functions/extract.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-pl/reference/array/functions/extract.xml diff -u phpdoc-pl/reference/array/functions/extract.xml:1.4 phpdoc-pl/reference/array/functions/extract.xml:1.5 --- phpdoc-pl/reference/array/functions/extract.xml:1.4 Fri May 17 09:50:48 2002 +++ phpdoc-pl/reference/array/functions/extract.xml Wed Feb 23 20:03:41 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.4 Maintainer: leszek Status: ready --> -<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.18 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.5 $ --> <refentry id="function.extract"> <refnamediv> <refname>extract</refname> @@ -27,12 +27,18 @@ </para> <note> <para> - Od wersji 4.0.5 ta funkcja zwraca liczbê wyekstraktowanych zmiennych. + Od wersji 4.0.5 ta funkcja zwraca liczbê wyekstrahowanych zmiennych. </para> </note> <note> <para> - Sta³e EXTR_IF_EXISTS i EXTR_PREFIX_IF_EXISTS zosta³y dodane w PHP 4.2.0. + Sta³e <constant>EXTR_IF_EXISTS</constant> i + <constant>EXTR_PREFIX_IF_EXISTS</constant> zosta³y dodane w PHP 4.2.0. + </para> + </note> + <note> + <para> + Sta³a <constant>EXTR_REFS</constant> zosta³a dodana w PHP 4.3.0. </para> </note> <para> @@ -44,7 +50,7 @@ warto¶ci: <variablelist> <varlistentry> - <term>EXTR_OVERWRITE</term> + <term><constant>EXTR_OVERWRITE</term></constant> <listitem> <simpara> Je¶li istnieje kolizja, nadpisz istniej±c± zmienn±. @@ -52,7 +58,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_SKIP</term> + <term><constant>EXTR_SKIP</term></constant> <listitem> <simpara> Je¶li istnieje kolizja, nie nadpisuj istniej±cej zmiennej. @@ -60,7 +66,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_SAME</term> + <term><constant>EXTR_PREFIX_SAME</term></constant> <listitem> <simpara> Je¶li istnieje kolizja, na pocz±tek nazwy zmiennej wstaw @@ -69,7 +75,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_ALL</term> + <term><constant>EXTR_PREFIX_ALL</term></constant> <listitem> <simpara> Na pocz±tek ka¿dej nazwy zmiennej wstaw <parameter>prefiks</parameter>. @@ -78,7 +84,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_INVALID</term> + <term><constant>EXTR_PREFIX_INVALID</term></constant> <listitem> <simpara> Wstaw <parameter>prefiks</parameter> na pocz±tek z³ych/numerycznych @@ -87,18 +93,18 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_IF_EXISTS</term> + <term><constant>EXTR_IF_EXISTS</term></constant> <listitem> <simpara> Nadpisz tylko zmienn± ju¿ istniej±c± w bie¿±cej tablicy symboli. Jest - to przydatne do definiowania listy poprawnych zmiennych i ekstraktuj + to przydatne do definiowania listy poprawnych zmiennych i ekstrahuj tylko te zmienne które zdefiniowano na przyk³ad w $_REQUEST. Flaga ta zosta³a dodana w PHP 4.2.0. </simpara> </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_IF_EXISTS</term> + <term><constant>EXTR_PREFIX_IF_EXISTS</term></constant> <listitem> <simpara> Przedrostek zostanie dodany tylko do zmiennych których odpowiedniki @@ -107,25 +113,56 @@ </simpara> </listitem> </varlistentry> + <varlistentry> + <term><constant>EXTR_REFS</constant></term> + <listitem> + <simpara> + Ekstraktuje zmienne jako referencje. Oznacza to, ¿e warto¶ci + zaimportowanych zmiennych ci±gle odnosz± siê do warto¶ci parametru + <parameter>tablica_zmiennych</parameter>. Flaga ta mo¿e byæ u¿yta + sama lub w po³±czaniu z innymi flagami poprzez u¿ycie operacji OR na + parametrze <parameter>typ_ekstrakcji</parameter>. Zosta³a ona dodana + w PHP 4.3.0. + </simpara> + </listitem> + </varlistentry> </variablelist> </para> <para> Je¶li <parameter>typ_ekstrakcji</parameter> nie zosta³ podany, to - zak³adana jest opcja EXTR_OVERWRITE. + zak³adana jest opcja <constant>EXTR_OVERWRITE</constant>. </para> <para> Zauwa¿, ¿e parametr <parameter>prefiks</parameter> jest wymagany tylko - je¶li <parameter>typ_ekstrakcji</parameter> to EXTR_PREFIX_SAME, - EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID lub EXTR_PREFIX_IF_EXISTS. Je¶li - nazwa zmiennej po dodaniu prefiksu nie jest prawid³ow± nazw± zmiennej, - nie jest importowana do tablicy symboli. + je¶li <parameter>typ_ekstrakcji</parameter> to + <constant>EXTR_PREFIX_SAME</constant>, + <constant>EXTR_PREFIX_ALL</constant>, + <constant>EXTR_PREFIX_INVALID<constant> lub + <constant>EXTR_PREFIX_IF_EXISTS</constant>. Je¶li nazwa zmiennej po + dodaniu prefiksu nie jest prawid³ow± nazw± zmiennej, nie jest + importowana do tablicy symboli. </para> <para> <function>extract</function> zwraca liczbê zmiennych szczê¶liwie zaimportowanych do tablicy symboli. </para> + <warning> + <para> + Nie nale¿y u¿ywaæ funkcji <function>extract</function> na niepewnych + danych, jak na przyk³ad danych odebranych od u¿ytkownika ($_GET, ...). + Mo¿na tak zrobiæ na przyk³ad w celu tymczasowego uruchomienia starych + skryptów, które zale¿ne s± od ustawienia <link + linkend="security.globals">register_globals</link>. Nale¿y jednak u¿yæ + nie nadpisuj±cego parametru <parameter>typ_ekstrakcji</parameter>, jak + na przyk³ad <constant>EXTR_SKIP</constant>. Trzeba te¿ pamiêtaæ aby + ekstrahowaæ zmienne <varname>$_SERVER</varname>, + <varname>$_SESSION</varname>, <varname>$_COOKIE</varname>, + <varname>$_POST</varname> <varname>$_GET</varname> w tej w³a¶nie + kolejno¶ci. + </para> + </warning> <para> - Mo¿liwy jest import zmiennych zawartych w tablicy asocjacyjnej zwróconej + Mo¿liwa jest ekstrakcja zmiennych zawartych w tablicy asocjacyjnej zwróconej przez <function>wddx_deserialize</function>. </para> <para> @@ -139,41 +176,40 @@ wddx_deserialize */ $rozmiar = "du¿y"; -$tablica_zmiennych = array ("kolor" => "niebieski", - "rozmiar" => "¶redni", - "ksztalt" => "kulisty"); -extract ($tablica_zmiennych, EXTR_PREFIX_SAME, "wddx"); +$tablica_zmiennych = array("kolor" => "niebieski", + "rozmiar" => "¶redni", + "ksztalt" => "kulisty"); +extract($tablica_zmiennych, EXTR_PREFIX_SAME, "wddx"); -print "$kolor, $rozmiar, $ksztalt, $wddx_rozmiar\n"; +echo "$kolor, $rozmiar, $ksztalt, $wddx_rozmiar\n"; ?> ]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad wy¶wietli: - <programlisting> + <screen> <![CDATA[ niebieski, du¿y, kulisty, ¶redni ]]> - </programlisting> + </screen> + </example> </para> <para> <varname>$rozmiar</varname> nie zosta³ nadpisany, poniewa¿ podany zosta³ - parametr EXTR_PREFIX_SAME, przez co stworzona zosta³ zmienna - <varname>$wddx_rozmiar</varname>. Je¶li podana by by³a flaga EXTR_SKIP, - to zmienna <varname>$wddx_rozmiar</varname> nie zosta³aby stworzona. - Flaga EXTR_OVERWRITE spowodowa³aby, ¿e zmienna <varname>$rozmiar</varname> - mia³aby warto¶æ "¶redni", a EXTR_PREFIX_ALL spowodowa³aby ¿e wszystkie - nowe zmienne zosta³yby nazwane <varname>$wddx_kolor</varname>, - <varname>$wddx_rozmiar</varname>, and - <varname>$wddx_ksztalt</varname>. + parametr <constant>EXTR_PREFIX_SAME</constant>, przez co stworzona zosta³ + zmienna <varname>$wddx_rozmiar</varname>. Je¶li podana by by³a flaga + <constant>EXTR_SKIP</constant>, to zmienna + <varname>$wddx_rozmiar</varname> nie zosta³aby stworzona. Flaga + <constant>EXTR_OVERWRITE</constant> spowodowa³aby, ¿e zmienna + <varname>$rozmiar</varname> mia³aby warto¶æ "¶redni", a + <constant>EXTR_PREFIX_ALL</constant> spowodowa³aby ¿e wszystkie nowe + zmienne zosta³yby nazwane <varname>$wddx_kolor</varname>, + <varname>$wddx_rozmiar</varname>, and <varname>$wddx_ksztalt</varname>. </para> <para> Musisz u¿yæ tablic asocjacyjnych. Tablica indeksowana liczbowo nie da - ¿adnych efektów, chyba ¿e zostanie u¿yta flaga EXTR_PREFIX_ALL lub - EXTR_PREFIX_INVALID. + ¿adnych efektów, chyba ¿e zostanie u¿yta flaga + <constant>EXTR_PREFIX_ALL</constant> lub + <constant>EXTR_PREFIX_INVALID</constant>. </para> <para> Patrz tak¿e: <function>compact</function>.