svn: /phpdoc/es/trunk/reference/strings/functions/ trim.xml
| From: | Yago Ferrer | Date: | Mon, 06 Dec 2010 05:34:38 +0000 |
| Subject: | svn: /phpdoc/es/trunk/reference/strings/functions/ trim.xml | ||
| Groups: | php.doc.es | ||
| Request: | Send a blank email to doc-es+get-3861@lists.php.net to get a copy of this message | ||
yago Mon, 06 Dec 2010 05:34:38 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=305994
Log:
updated to the most recent version.
Changed paths:
A phpdoc/es/trunk/reference/strings/functions/trim.xml
Added: phpdoc/es/trunk/reference/strings/functions/trim.xml
===================================================================
--- phpdoc/es/trunk/reference/strings/functions/trim.xml (rev 0)
+++ phpdoc/es/trunk/reference/strings/functions/trim.xml 2010-12-06 05:34:38 UTC (rev 305994)
@@ -0,0 +1,248 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 297028 Maintainer: yago Status: ready -->
+<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
+<refentry xmlns="http://docbook.org/ns/docbook"
xml:id="function.trim">
+ <refnamediv>
+ <refname>trim</refname>
+ <refpurpose>Elimina espacio en blanco (u otro tipo de caracteres) del inicio y el final de
la cadena</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>string</type><methodname>trim</methodname>
+
<methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam
choice="opt"><type>string</type><parameter>charlist</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Esta función devuelve una cadena con los espacios en blanco eliminados del
+ inicio y final del <parameter>str</parameter>.
+ sin el segundo parámetro,
+ <function>trim</function> eliminará estos caracteres:
+ <!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim -->
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ " " (<acronym>ASCII</acronym> <literal>32</literal>
+ (<literal>0x20</literal>)), espacio simple.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "\t" (<acronym>ASCII</acronym> <literal>9</literal>
+ (<literal>0x09</literal>)), tabulación.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "\n" (<acronym>ASCII</acronym> <literal>10</literal>
+ (<literal>0x0A</literal>)), salto de línea.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "\r" (<acronym>ASCII</acronym> <literal>13</literal>
+ (<literal>0x0D</literal>)), retorno de carro.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "\0" (<acronym>ASCII</acronym> <literal>0</literal>
+ (<literal>0x00</literal>)), el byte <literal>NUL</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara> <!-- not \v, since not supported by PHP -->
+ "\x0B" (<acronym>ASCII</acronym> <literal>11</literal>
+ (<literal>0x0B</literal>)), tabulación vertical.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>str</parameter></term>
+ <listitem>
+ <para>
+ La <type>cadena</type> que será recortada.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>charlist</parameter></term>
+ <listitem>
+ <para>
+ De manera opcional, los caracteres a ser eliminados pueden ser especificados usando
+ el parámetro <parameter>charlist</parameter>.
+ Simplemente lista todos los caracteres que se quieran eliminar. Se puede especificar
+ un rango de caracteres usando <literal>..</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ La cadena recortada.
+ </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>4.1.0</entry>
+ <entry>
+ Se añadió el parámetro <parameter>charlist</parameter>.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Ejemplo de uso de <function>trim</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+$text = "\t\tThese are a few words :) ... ";
+$binary = "\x09Example string\x0A";
+$hello = "Hello World";
+var_dump($text, $binary, $hello);
+
+print "\n";
+
+$trimmed = trim($text);
+var_dump($trimmed);
+
+$trimmed = trim($text, " \t.");
+var_dump($trimmed);
+
+$trimmed = trim($hello, "Hdle");
+var_dump($trimmed);
+
+// Elimina los caracteres de control ASCII al inicio y final de $binary
+// (from 0 to 31 inclusive)
+$clean = trim($binary, "\x00..\x1F");
+var_dump($clean);
+
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+string(32) " These are a few words :) ... "
+string(16) " Example string
+"
+string(11) "Hello World"
+
+string(28) "These are a few words :) ..."
+string(24) "These are a few words :)"
+string(5) "o Wor"
+string(14) "Example string"
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Uso de <function>trim</function> en valores de un array</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function trim_value(&$value)
+{
+ $value = trim($value);
+}
+
+$fruit = array('apple','banana ', ' cranberry ');
+var_dump($fruit);
+
+array_walk($fruit, 'trim_value');
+var_dump($fruit);
+
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+array(3) {
+ [0]=>
+ string(5) "apple"
+ [1]=>
+ string(7) "banana "
+ [2]=>
+ string(11) " cranberry "
+}
+array(3) {
+ [0]=>
+ string(5) "apple"
+ [1]=>
+ string(6) "banana"
+ [2]=>
+ string(9) "cranberry"
+}
+
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>ltrim</function></member>
+ <member><function>rtrim</function></member>
+ </simplelist>
+ </para>
+ </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:"~/.phpdoc/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
+-->
\ No newline at end of file
Property changes on: phpdoc/es/trunk/reference/strings/functions/trim.xml
___________________________________________________________________
Added: svn:keywords
+ Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
+ native