cvs: phpdoc-pl /reference/array/functions range.xml
| From: | Leszek Krupinski | 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>