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

jpberdejo Sat, 11 Dec 2010 15:21:17 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=306224 Log: New translated file Changed paths: A phpdoc/es/trunk/reference/strings/functions/ltrim.xml Added: phpdoc/es/trunk/reference/strings/functions/ltrim.xml =================================================================== --- phpdoc/es/trunk/reference/strings/functions/ltrim.xml (rev 0) +++ phpdoc/es/trunk/reference/strings/functions/ltrim.xml 2010-12-11 15:21:17 UTC (rev 306224) @@ -0,0 +1,206 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision$ --> +<!-- EN-Revision: 297028 Maintainer: jpberdejo Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ltrim"> + <refnamediv> + <refname>ltrim</refname> + <refpurpose>Retira espacios en blanco (u otros caracteres) del inicio de un string</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>ltrim</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charlist</parameter></methodparam> + </methodsynopsis> + <para> + Retira espacios en blanco (u otros caracteres) del inicio de un string. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + El string de entrada. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charlist</parameter></term> + <listitem> + <para> + Se puede también especificar los caracteres que se desean retirar por medio del + parámetro <parameter>charlist</parameter>. + Simplemente se listan todos los caracteres que se quieren retirar. Con + <literal>..</literal> se puede especificar un rango de caracteres. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Esta función devuelve un string con los espacios en blanco retirados del + inicio de <parameter>str</parameter>. + Sin el segundo parámetro, <function>ltrim</function> retirará estos caracteres: + <!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim --> + <itemizedlist> + <listitem> + <simpara> + " " (<acronym>ASCII</acronym> <literal>32</literal> + (<literal>0x20</literal>)), un espacio ordinario. + </simpara> + </listitem> + <listitem> + <simpara> + "\t" (<acronym>ASCII</acronym> <literal>9</literal> + (<literal>0x09</literal>)), un tabulador. + </simpara> + </listitem> + <listitem> + <simpara> + "\n" (<acronym>ASCII</acronym> <literal>10</literal> + (<literal>0x0A</literal>)), una nueva línea (line feed). + </simpara> + </listitem> + <listitem> + <simpara> + "\r" (<acronym>ASCII</acronym> <literal>13</literal> + (<literal>0x0D</literal>)), un retorno de carro. + </simpara> + </listitem> + <listitem> + <simpara> + "\0" (<acronym>ASCII</acronym> <literal>0</literal> + (<literal>0x00</literal>)), el byte <literal>NULL</literal>. + </simpara> + </listitem> + <listitem> + <simpara> <!-- not \v, since not supported by PHP --> + "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> + (<literal>0x0B</literal>)), un tabulador vertical. + </simpara> + </listitem> + </itemizedlist> + </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> + Fue agregado 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>ltrim</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 = ltrim($text); +var_dump($trimmed); + +$trimmed = ltrim($text, " \t."); +var_dump($trimmed); + +$trimmed = ltrim($hello, "Hdle"); +var_dump($trimmed); + +// retira los caracteres ASCII de control al inicio de $binary +// (de 0 a 31 inclusive) +$clean = ltrim($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(30) "These are a few words :) ... " +string(30) "These are a few words :) ... " +string(7) "o World" +string(15) "Example string +" +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>trim</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 +--> + Property changes on: phpdoc/es/trunk/reference/strings/functions/ltrim.xml ___________________________________________________________________ Added: svn:keywords + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL Added: svn:eol-style + native