svn: /phpdoc/es/trunk/reference/strings/functions/ trim.xml

From: 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

« previous php.doc.es (#3861) next »