cvs: phpdoc-pl /reference/array/functions range.xml

From: Date: Thu, 24 Feb 2005 01:03:57 +0000
Subject: cvs: phpdoc-pl /reference/array/functions range.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-446@lists.php.net to get a copy of this message
leszek Wed Feb 23 20:03:57 2005 EDT Modified files: /phpdoc-pl/reference/array/functions range.xml Log: [leszek] - updated to 1.15 http://cvs.php.net/diff.php/phpdoc-pl/reference/array/functions/range.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-pl/reference/array/functions/range.xml diff -u phpdoc-pl/reference/array/functions/range.xml:1.4 phpdoc-pl/reference/array/functions/range.xml:1.5 --- phpdoc-pl/reference/array/functions/range.xml:1.4 Fri May 17 09:50:48 2002 +++ phpdoc-pl/reference/array/functions/range.xml Wed Feb 23 20:03:56 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.15 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.5 $ --> <refentry id="function.range"> <refnamediv> <refname>range</refname> @@ -9,60 +9,87 @@ </refpurpose> </refnamediv> <refsect1> - <title>Opis</title> - <methodsynopsis> - <type>array</type><methodname>range</methodname> - <methodparam><type>mixed</type><parameter>dolny</parameter></methodparam> - <methodparam><type>mixed</type><parameter>górny</parameter></methodparam> - </methodsynopsis> + <title>Opis</title> + <methodsynopsis> + <type>array</type><methodname>range</methodname> + <methodparam><type>mixed</type><parameter>dolny</parameter></methodparam> + <methodparam><type>mixed</type><parameter>górny</parameter></methodparam> + <methodparam choice="opt"><type>number</type><parameter>krok</parameter></methodparam> + </methodsynopsis> <para> <function>range</function> zwraca tablicê elementów od <parameter>dolny</parameter> do <parameter>górny</parameter>, w³±cznie. Je¶li dolny > górny, to sekwencja bêdzie od górnego do dolnego. </para> - <example> - <title>Przyk³ady u¿ycia <function>range</function></title> - <programlisting role="php"> -<![CDATA[ -foreach(range(0, 9) as $liczba) { - echo $liczba; -} -foreach(range('a', 'z') as $litera) { - echo $litera; -} -foreach(range('z', 'a') as $litera) { - echo $litera; -} -]]> - </programlisting> - </example> <note> - <para> - Do wersji 4.1.0, funkcja <function>range</function> generowa³a tylko - rosn±ce tablice liczbowe. Obs³uga dla sekwencji znakowych i tablic - malej±cych zosta³a dodana w 4.1.0. - </para> + <title>Nowy parametr</title> + <simpara> + Parametr opcjonalny <parameter>krok</parameter> zosta³ dodany w PHP + 5.0.0. + </simpara> + </note> + <para> + Je¶li podany zostanie parametr <parameter>krok</parameter>, zostanie on + u¿yty jako ró¿nica pomiêdzy elementami w sekwencji. + <parameter>krok</parameter> powinien byæ liczb± dodatni±. Je¶li nie + zostanie on podany, <parameter>krok</parameter> przyjmie domy¶ln± warto¶æ + 1. + </para> + <para> <example> - <title>Symulowanie sekwencji malej±cych i znakowych</title> + <title>Przyk³ady u¿ycia funkcji <function>range</function></title> <programlisting role="php"> <![CDATA[ -# do odwrócenia kolejno¶ci sekwencji mo¿na u¿yæ array_reverse -foreach(array_reverse(range(0,9)) as $liczba) { +<?php +// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12) +foreach (range(0, 12) as $liczba) { echo $liczba; } -# funkcja array_map() mo¿e byæ u¿yta do zamiany liczb ca³kowitych na znaki -# u¿ywaj±c chr() -foreach(array_map('chr', range(ord('a'),ord('z'))) as $znak){ - echo $znak; +// Parametr kroku zosta³ wprowadzony w 5.0.0 +// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100) +foreach (range(0, 100, 10) as $liczba) { + echo $liczba; +} + +// U¿ycie sekwencji znakowych wprowadzono w 4.1.0 +// array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i'); +foreach (range('a', 'i') as $litera) { + echo $litera; } + +// array('c', 'b', 'a'); +foreach (range('c', 'a') as $litera) { + echo $litera; +} +?> ]]> </programlisting> </example> + </para> + <note> + <para> + W wersjach wcze¶niejszych od PHP 4.1.0 funkcja + <function>range</function> generowa³a tylko rosn±ce tablice liczbowe. + Obs³uga sekwencji znakowych i tablic malej±cych zosta³a wprowadzona w + PHP 4.1.0. Warto¶ci sekwencji znakowych s± ograniczone do d³ugo¶ci + jednego znaku. Je¶li wprowadzony zostanie ci±g d³ugo¶ci wiêkszej ni¿ + jeden, u¿yty zostanie tylko pierwszy znak. + </para> </note> + </note> + <caution> + <para> + W wersjach PHP od 4.1.0 do 4.3.2 funkcja <function>range</function> + rozpoznawa³a ci±gi numeryczne jako ci±gi, a nie jako liczby. W zwi±zku z + tym bêd± one u¿yte do generowania sekwencji znakowych. Na przyk³ad + <literal>"4242"</literal> bêdzie traktowane jako <literal>"4"</literal>. + </para> + </caution> <para> - Patrz tak¿e: <function>shuffle</function> aby zobaczyæ inny przyk³ad - wykorzystania tej funkcji. + Patrz tak¿e: <function>shuffle</function>, + function>array_fill</function> i <link + linkend="control-structures.foreach">foreach</link>. </para> </refsect1> </refentry>

« previous php.doc.pl (#446) next »