svn: /phpdoc/es/trunk/reference/ datetime/datetimezone/getname.xml strings/functions/substr.xml

yago Wed, 24 Nov 2010 05:16:40 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=305710 Log: updated to the most recent version. Changed paths: U phpdoc/es/trunk/reference/datetime/datetimezone/getname.xml U phpdoc/es/trunk/reference/strings/functions/substr.xml Modified: phpdoc/es/trunk/reference/datetime/datetimezone/getname.xml =================================================================== --- phpdoc/es/trunk/reference/datetime/datetimezone/getname.xml 2010-11-24 04:31:45 UTC (rev 305709) +++ phpdoc/es/trunk/reference/datetime/datetimezone/getname.xml 2010-11-24 05:16:40 UTC (rev 305710) @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 305678 Maintainer: agarzon Status: ready --> +<!-- EN-Revision: 305693 Maintainer: yago Status: ready --> <refentry xml:id="datetimezone.getname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> @@ -27,15 +27,12 @@ <refsect1 role="parameters"> &reftitle.parameters; - &style.oop; - &no.function.parameters; - &style.procedural; <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> - El DateTimeZone del cual desera obtener el nombre. + El <classname>DateTimeZone</classname> del cual desera obtener el nombre. </para> </listitem> </varlistentry> @@ -45,7 +42,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Una de las <link linkend="timezones">zonas horarias</link>. + Una de los nombres de zona horaria en la + <link linkend="timezones">lista de zonas horarias</link>. </para> </refsect1> Modified: phpdoc/es/trunk/reference/strings/functions/substr.xml =================================================================== --- phpdoc/es/trunk/reference/strings/functions/substr.xml 2010-11-24 04:31:45 UTC (rev 305709) +++ phpdoc/es/trunk/reference/strings/functions/substr.xml 2010-11-24 05:16:40 UTC (rev 305710) @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 302968 Maintainer: yago Status: ready --> +<!-- EN-Revision: 305175 Maintainer: yago Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr"> <refnamediv> <refname>substr</refname> @@ -29,7 +29,7 @@ <term><parameter>string</parameter></term> <listitem> <para> - La cadena de entrada. + La cadena de entrada. Debe ser de almenos de un caracter. </para> </listitem> </varlistentry> @@ -38,8 +38,8 @@ <listitem> <para> Si <parameter>start</parameter> no es negativo, la cadena devuelta - comenzará en <parameter>start</parameter> al inicio de la posición de la - cadena <parameter>string</parameter>, contando desde cero. Por ejemplo, + comenzará en el <parameter>start</parameter> de la posición del + <parameter>string</parameter> empezando desde cero. Por ejemplo, en la cadena '<literal>abcdef</literal>', el caracter en la posición <literal>0</literal> es '<literal>a</literal>', el caracter en la posición <literal>2</literal> es @@ -51,12 +51,12 @@ <parameter>string</parameter>. </para> <para> - Si la longitud de <parameter>string</parameter> es menor o igual a + Si la longitud del <parameter>string</parameter> es menor o igual a <parameter>start</parameter>, la función devolverá &false;. </para> <para> <example> - <title>Uso de <parameter>start</parameter> negativo</title> + <title>Usando un <parameter>start</parameter> negativo</title> <programlisting role="php"> <![CDATA[ <?php @@ -80,11 +80,11 @@ <parameter>string</parameter>). </para> <para> - Si se especifica <parameter>length</parameter> es negativo, - entonces ese número de caracteres se omiten al final del <parameter>string</parameter> + Si se especifica <parameter>length</parameter> es negativo, entonces ese número de caracteres + se omiten al final del <parameter>string</parameter> (después de la posición inicial se ha calculado a <parameter>start</parameter> es negativo). Si - <parameter>start</parameter> indica una posición más allá de este - truncamiento, se devolvera una cadena vacía. + <parameter>start</parameter> indica la posición de su truncamiento + o más allá, se devolverá false. </para> <para> Si se omite el <parameter>length</parameter>, la subcadena empezará por @@ -102,7 +102,7 @@ <?php $rest = substr("abcdef", 0, -1); // devuelve "abcde" $rest = substr("abcdef", 2, -1); // devuelve "cde" -$rest = substr("abcdef", 4, -4); // devuelve "" +$rest = substr("abcdef", 4, -4); // devuelve false $rest = substr("abcdef", -3, -1); // devuelve "de" ?> ]]> @@ -117,10 +117,36 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Devuelve la parte extraída de la cadena&return.falseforfailure;. + Devuelve la parte extraída de la cadena&return.falseforfailure; o una cadena vacía. </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.2</entry> + <entry> + Si el parámetro <parameter>start</parameter> indica una posición negativa de + truncamiento o más allá, se devolverá false. En la versión anterior de PHP, + se devolvía una cadena vacía. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -146,9 +172,43 @@ ]]> </programlisting> </example> + <example> + <title>Comportamiento de casting de <function>substr</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +class apple { + public function __toString() { + return "green"; + } +} + +echo "1) ".var_export(substr("pear", 0, 2), true).PHP_EOL; +echo "2) ".var_export(substr(54321, 0, 2), true).PHP_EOL; +echo "3) ".var_export(substr(new apple(), 0, 2), true).PHP_EOL; +echo "4) ".var_export(substr(true, 0, 1), true).PHP_EOL; +echo "5) ".var_export(substr(false, 0, 1), true).PHP_EOL; +echo "6) ".var_export(substr("", 0, 1), true).PHP_EOL; +echo "7) ".var_export(substr(1.2e3, 0, 4), true).PHP_EOL; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +1) 'pe' +2) '54' +3) 'gr' +4) '1' +5) false +6) false +7) '1200' +]]> + </screen> + </example> </para> </refsect1> - + <refsect1 role="errors"> &reftitle.errors; <para> @@ -162,7 +222,7 @@ ]]> </programlisting> </example> - </para> + </para> </refsect1> <refsect1 role="seealso">