<?xml version="1.0" encoding="iso-8859-1"?>
<reference id="ref.strings">
  <title>Funciones de cadenas</title>
  <titleabbrev>Cadenas</titleabbrev>

  <partintro>
   <simpara>
    Todas estas funciones manipulan cadenas de varias maneras. En las
    secciones sobre expresiones regulares y manejo de URL se pueden
    encontrar secciones ms especializadas.
   </simpara>
  </partintro>

  <refentry id="function.addcslashes">
   <refnamediv>
    <refname>AddCSlashes</refname>
    <refpurpose>Marca una cadena con barras al estilo del C</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>addcslashes</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam><type>string</type><parameter>listcar</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena con barras invertidas antes de los caracteres
     listados en el parmetro <parameter>listcar</parameter>. Tambin
     marca <literal>\n</literal>, <literal>\r</literal> etc. Al estilo
     del C, los caracteres con cdico ASCII inferior a 32 y superior a
     126 son convertidos a representacin octal. Tenga cuidado cuando
     marque caracteres alfanumricos. Puede especificar un rango en
     <parameter>listcar</parameter> como el "\0..\37", que marcara
     todos los caracteres con cdigo ASCII entre 0 y 31.
     <example>
      <title>Ejemplo de <function>addcslashes</function></title>
      <programlisting role="php">
$tradformado = addcslashes ($no_transf, "\0..\37!@\177..\377");
      </programlisting>
     </example>
     <note>
      <simpara>
       Aadida en PHP4b3-dev.</simpara>
     </note>
    </para>
    <para>
     Vea tambin <function>stripcslashes</function>, 
     <function>stripslashes</function>, 
     <function>htmlspecialchars</function>,
     <function>htmlspecialchars</function>, y
     <function>quotemeta</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.addslashes">
   <refnamediv>
    <refname>AddSlashes</refname>
    <refpurpose>Marca una cadena con barras</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>addslashes</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena con barras invertidas frente a los caracteres
     que necesitan marcarse en consultas de bases de datos, etc. Estos
     son la comilla simple (<literal>'</literal>), comilla doble
     (<literal>"</literal>), barra invertida (<literal>\</literal>)
     y NUL (el byte nulo).
    </para>
    <para>
     Vea tambin <function>stripslashes</function>, 
     <function>htmlspecialchars</function>, y
     <function>quotemeta</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.bin2hex">
   <refnamediv>
    <refname>bin2hex</refname>
    <refpurpose>
     Convierte datos binarios en su representacin hexadecimal
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>bin2hex</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena ASCII que contiene la representacin hexadecimal
     de <parameter>cad</parameter>. La conversin se realiza byte a byte,
     con los 4 bits superiores primero.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chop">
   <refnamediv>
    <refname>chop</refname>
    <refpurpose>Elimina espacios sobrantes al final</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>chop</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la cadena argumento sin los espacios sobrantes,
     incluyendo los saltos de lnea.
     <example>
      <title>Ejemplo de <function>chop</function></title>
      <programlisting role="php">
$recortada = chop ($linea);
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>trim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chr">
   <refnamediv>
    <refname>chr</refname>
    <refpurpose>Devuelve un caracter especfico</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>chr</methodname>
      <methodparam><type>int</type><parameter>ascii</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena de un caracter que congiene el caracter
     especificado por <parameter>ascii</parameter>.
     <example>
      <title>Ejemplo de <function>chr</function></title>
      <programlisting role="php">
$cad .= chr (27); /* aade un caracter de escape al final de $cad */

/* A veces esto es ms til */

$cad = sprintf ("La cadena termina en escape: %c", 27);
      </programlisting>
     </example>
     Esta funcin complementa a <function>ord</function>. Vea tambin
     <function>sprintf</function> con una cadena de formato 
     <literal>%c</literal>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.chunk-split">
   <refnamediv>
    <refname>chunk_split</refname>
    <refpurpose>Divide una cadena en trozos ms pequeos</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>chunk_split</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>tamatrozo</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>final</parameter></methodparam>
     </methodsynopsis>
    <para>
     Se puede utilizar para trocear una cadena en pedazos ms pequeos,
     lo que es til, p.ej., para convertir la salida de la funcin <link
     linkend="function.base64-encode">base64_encode</link> a la semntica
     del RFC 2045. Inserta la cadena <parameter>final</parameter> cada
     <parameter>tamatrozo</parameter> (por defecto vale 76) caracteres.
     Devuelve la nueva cadena y deja intacta la original.
     <example>
      <title>Ejemplo de <function>chunk_split</function></title>
      <programlisting role="php">
# formatear $datos usando la semntica del RFC 2045

$nueva_cad = chunk_split (base64_encode($datos));
      </programlisting>
     </example>
     Esta funcin es notablemente ms rpida que
     <function>ereg_replace</function>.
     <note>
      <para>
       Esta funcin se aadi en la 3.0.6.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.convert-cyr-string">
   <refnamediv>
    <refname>convert_cyr_string</refname>
    <refpurpose>
     Convierte de un juego de caracteres Cirlico a otro
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>convert_cyr_string</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam><type>string</type><parameter>desde</parameter></methodparam>
      <methodparam><type>string</type><parameter>hasta</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin convierte la cadena dada de un juego de caracteres
     Cirlico a otro. Los argumentos <parameter>desde</parameter> y
     <parameter>hasta</parameter> son caracteres sencillos que 
     representan los juegos de caracteres Cirlicos fuente y destino.
     Los tipos soportados son:
     <itemizedlist>
      <listitem>
       <simpara>
        k - koi8-r
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        w - windows-1251
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        i - iso8859-5
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        a - x-cp866
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        d - x-cp866
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        m - x-mac-cyrillic
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.count-chars">
   <refnamediv>
    <refname>count_chars</refname>
    <refpurpose>
     Devuelve informacin sobre los caracteres usados en una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>mixed</type><methodname>count_chars</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
      <methodparam choice="opt"><type></type><parameter>
        modo
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Cuenta el nmero de apariciones de cada valor de byte (0..255)
     en <parameter>cadena</parameter> y lo devuelve de varias maneras.
     El parmetro opcional <parameter>modo</parameter> vale por defecto
     0. Dependiendo de <parameter>modo</parameter>,
     <function>count_chars</function> puede devolver:
     <itemizedlist>
      <listitem>
       <simpara>
        0 - una matriz con el valor del byte como clave y la frecuencia
        de cada uno como valor.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        1 - como el 0, pero listando nicamente los valores de byte con
        frecuencia superior a cero.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        2 - como el 0, pero listando nicamente los valores de byte con
        frecuencia igual a 0.  
       </simpara>
      </listitem> 
      <listitem>
       <simpara> 
        3 - se devuelve una cadena que contiene todos los valores de byte
        utilizados.
       </simpara>
      </listitem> 
      <listitem>
       <simpara> 
        4 - se devuelve una cadena que contiene todos los valores de byte
        no utilizados.
       </simpara>
      </listitem> 
     </itemizedlist>
    </para>
    <note>
     <para>
      Esta funcin se aadi en el PHP 4.0.
     </para> 
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.crc32">
   <refnamediv>
    <refname>crc32</refname>
    <refpurpose>Calcula el polinomio crc32 de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>crc32</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
         Genera el polinomio de comprobacin de reduncancia cclica de 32 bits
         de <parameter>cad</parameter>. Se suele utilizar para validad la
         integridad de los datos transmitidos.
    </para>
        <para>
        Vea tambin: <function>md5</function>
        </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.crypt">
   <refnamediv>
    <refname>crypt</refname>
    <refpurpose>Encripta una cadena mediante DES</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>crypt</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>semilla</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>crypt</function> encriptar una cadena utilizando el
     mtodo estndar de encriptacin del Unix <abbrev>DES</abbrev>.
     Los argumentos son una cadena a encriptar y una cadena semilla
     de 2 caracteres en la que basar la encriptacin. Vea la pgina de
     manual de Unix sobre crypt para ms informacin.
    </para>
    <simpara>
     Si el argumento de semilla no se proporciona, ser generado
     aleatoriamente por el PHP.
    </simpara>
    <simpara>
     Algunos sistemas operativos soportan ms de un tipo de encriptacin.
     De hecho, algunas veces la encriptacin estndar DES es sustituda
     por un algoritmo de encriptacin basado en MD5. El tipo de
     encriptacin es disparado por el argumento semilla. En tiempo de
     instalacin, el PHP determina la capacidad de la funcin de
     encriptacin y aceptar semillas para otros tipos de encriptacin.
     Si no se proporciona la semilla, el PHP intentar generar una
     semilla estndar DES de 2 caraceres por defecto, excepto si el
     tipo de encriptacin estndar del sistema es el MD5, en cuyo caso
     se generar una semilla aleatoria compatible con MD5. El PHP
     fija una constante llamada CRYPT_SALT_LENGTH que le especifica si
     su sistema soporta una semilla de 2 caracteres o si se debe usar
     la semilla de 12 caracteres del NDS.
    </simpara>
    <simpara>
     La funcin estndar de encriptacin <function>crypt</function> contiene
     la semilla como los dos primeros caracteres de la salida.
    </simpara>
    <simpara>
     En los sistemas en los que la funcin crypt() soporta mltiples
     tipos de encriptacin, las siguienes constantes son fijadas a
     0  1 dependiendo de si est disponible el tipo dado:
     </simpara>
    <itemizedlist>
     <listitem>
      <simpara>
       CRYPT_STD_DES - Encriptacin DES estndar con semilla de 2 caracteres
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_EXT_DES - Encriptacin DES extendida con semilla de 9 caracteres
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_MD5 - Encriptacin MD5 con semilla de 12 caracteres y comenzando
       por $1$
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_BLOWFISH - Encriptacin DES extendida con semilla de 16 caracteres
       y comenzando por $2$
      </simpara>
     </listitem>
    </itemizedlist>
    <simpara>
     No hay funcin de desencriptado porque <function>crypt</function>
     utiliza un algoritmo de una sola va.
    </simpara>
    <simpara>
        Vea tambin: <function>md5</function>.
    </simpara>
   </refsect1>
  </refentry>
  <refentry id="function.echo">
   <refnamediv>
    <refname>echo</refname>
    <refpurpose>Da salida a una o ms cadenas</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <methodname>echo</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>argn...</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Da salida a todos sus parmetros.
    </simpara>
    <para>
     <function>echo</function> no es realmente una funcin (es una
     sentencia del lenguaje) de modo que no se requiere el uso de
     los parntesis.  
     <example>
      <title>Ejemplo de <function>echo</function></title>
      <programlisting role="php">
echo "Hola Mundo";

echo "Esto se extiende
por varias lneas. Los saltos de lnea
tambin se envan";

echo "Esto se extiende\npor varias lneas. Los saltos de lnea\ntambin se envan";
      </programlisting>
     </example>
    </para>      
    <note>
     <para>
      De hecho, si desea pasar ms de un parmetro a echo no debe
      encerrarlos entre parntesis.
     </para>
    </note>
    <simpara>
     Vea tambin:
     <function>print</function>,
     <function>printf</function>, y
     <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.explode">
   <refnamediv>
    <refname>explode</refname>
    <refpurpose>Divide una cadena por otra</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>array</type><methodname>explode</methodname>
      <methodparam><type>string</type><parameter>separador</parameter></methodparam>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>limite</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una matriz de cadenas, cada una de las cuales es una
     subcadena de <parameter>cadena</parameter> formada mediante su
     divisin en las fronteras marcadas por la cadena 
     <parameter>separador</parameter>. Si se especifica <parameter>limite</parameter>,
     la matriz devuelta contendr un mximo de <parameter>limite</parameter>
     elementos con el ltimo conteniendo el resto de la
     <parameter>cadena</parameter>.
    </para>
    <para>
     <example>
      <title>Ejemplo de <function>explode</function></title>
      <programlisting role="php">
$pizza = "trozo1 trozo2 trozo3 trozo4 trozo5 trozo6";
$trozos = explode (" ", $pizza);
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>split</function> e
     <function>implode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.get-html-translation-table">
   <refnamediv>
    <refname>get_html_translation_table</refname>
    <refpurpose>
     Devuelve la tabla de traduccin utilizada por 
     <function>htmlspecialchars</function> y
     <function>htmlentities</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>get_html_translation_table</methodname>
      <methodparam><type>int</type><parameter>tabla</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>get_html_translation_table</function> devolver la
     tabla de traduccin que se usa internamente para 
     <function>htmlspecialchars</function> y
     <function>htmlentities</function>. Hay dos nuevas definiciones
     (<parameter>HTML_ENTITIES</parameter>,
     <parameter>HTML_SPECIALCHARS</parameter>) que le permiten
     especificar la tabla deseada.
     <example>
      <title>Ejemplo de Tabla de Traduccin</title>
      <programlisting role="php">
$trad = get_html_translation_table (HTML_ENTITIES);
$cad = "Hallo &amp; &lt;Frau> &amp; Kr&auml;mer";
$codif = strtr ($cad, $trad);
      </programlisting>
     </example>
     La variable <literal>$codif</literal> contendr ahora: "Hallo
     &amp;<sgmltag>amp</sgmltag>;
     &amp;<sgmltag>lt</sgmltag>;Frau&amp;<sgmltag>gt</sgmltag>;
     &amp;<sgmltag>amp</sgmltag>; Kr&amp;<sgmltag>auml</sgmltag>;mer".
    </para>
    <para>
     Lo interesante es usar la funcin <function>array_flip</function>
     para cambiar la direccin de la traduccin.
     <informalexample>
      <programlisting role="php">
$trad = array_flip ($trad);
$original = strtr ($cad, $trad);
      </programlisting>
     </informalexample>
      El contenido de <literal>$original</literal> sera: "Hallo &amp;
      &lt;Frau> &amp; Kr&auml;mer".
     <note>
      <para>
       Esta funcin fue aadida en PHP 4.0.
      </para> 
     </note>
    </para>
    <para>
     Vea tambin: <function>htmlspecialchars</function>,
     <function>htmlentities</function>, <function>strtr</function>,
     y <function>array_flip</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.get-meta-tags">
   <refnamediv>
    <refname>get_meta_tags</refname>
    <refpurpose>
     Extrae todas las etiquetas meta de un archivo y retorna una matriz
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>array</type><methodname>get_meta_tags</methodname>
      <methodparam><type>string</type><parameter>nombrefich</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_ruta_include</parameter></methodparam>
     </methodsynopsis>
    <para>
     Abre el <parameter>nombrefich</parameter> y lo trocea lnea a lnea
     buscando etiquetas &lt;meta> de la forma
     <example>
      <title>Ejemplo de Etiquetas Meta</title>
      <programlisting role="html">
&lt;meta name="autor" content="nombre">
&lt;meta name="etiquetas" content="documentacin de php3">
&lt;/head> &lt;!-- el proceso se detiene aqu -->
      </programlisting>
     </example>
     (preste atencin a los finales de lnea - el PHP utiliza una
     funcin nativa para trocear la entrada, de modo que un archivo
     de Mac no funcionar en Unix).
    </para>
    <para> 
     El valor de la propiedad name queda como clave y el valor de la
     propiedad content queda como el valor de la matriz devuelta, de
     modo que pueda usar fcilmente funciones estndar de matrices para
     recorrerla o para acceder a valores individuales. Los caracteres
     especiales en el valor de name son sustitudos por '_' y el resto
     es convertido a minsculas.
    </para>
    <para>
     Fijando <parameter>use_ruta_include</parameter> a 1 har que el
     PHP intente abrir el archivo a travs de la ruta de inclusin.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrev">
   <refnamediv>
    <refname>hebrev</refname>
    <refpurpose>
     Convierte Hebreo lgico a texto visual
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>hebrev</methodname>
      <methodparam><type>string</type><parameter>texto_hebreo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>max_cars_por_linea</parameter></methodparam>
     </methodsynopsis>
    <para>
    	  El parmetro opcional <parameter>max_cars_por_linea</parameter>
    	  indica el mximo nmero de caracteres que se emitirn por lnea.
    	  La funcin intenta evitar cortar palabras.
    </para>
        <para>
     Vea tambin <function>hebrevc</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrevc">
   <refnamediv>
    <refname>hebrevc</refname>
    <refpurpose>
     Convierte Hebreo lgico a texto visual con conversin de saltos
     de lnea
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>hebrevc</methodname>
      <methodparam><type>string</type><parameter>texto_hebreo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>max_cars_por_linea</parameter></methodparam>
     </methodsynopsis>
    <para>
    	  Esta funcion es similar a <function>hebrev</function> con la 
    	  diferencia que convierte las nuevas lneas (\n) a "&lt;br&gt;\n".
    	  El parmetro opcional <parameter>max_cars_por_linea</parameter>
    	  indica el mximo nmero de caracteres que se emitirn por lnea.
    	  La funcin intenta evitar cortar palabras.
    </para>
        <para>
     Vea tambin <function>hebrev</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.htmlentities">
   <refnamediv>
    <refname>htmlentities</refname>
    <refpurpose>
     Convierte todos los caracteres aplicables a entidades HTML
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlentities</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin es del todo idntica a <function>htmlspecialchars</function>,
     excepto que traduce todos los caracteres que tienen equivalente
     como entidad HTML.
    </para>
    <para>
     Actualmente se utiliza el juego de caracteres ISO-8859-1.
    </para>
    <para>
     Vea tambin <function>htmlspecialchars</function> y
     <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.htmlspecialchars">
   <refnamediv>
    <refname>htmlspecialchars</refname> 
    <refpurpose>
     Convierte caracteres especiales a entidades HTML
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlspecialchars</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ciertos caracteres tienen significados especiales en HTML, y deben
     ser representados por entidades HTML si se desea preservar su
     significado. Esta funcin devuelve una cadena con dichas conversiones
     realizadas.
    </para>
    <simpara>
     Esta funcin es til para evitar que el texo entrado por el usuario
     contenga marcas HTML, como ocurre en aplicaciones de foros o
     libros de visita.
    </simpara>
    <para>
     Actualmente, las traducciones hechas son:
     <itemizedlist>
      <listitem>
       <simpara>
        '&amp;' (ampersand) se convierte en '&amp;amp;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&quot;' (doble comilla) se convierte en '&amp;quot;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&lt;' (menor que) se convierte en '&amp;lt;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&gt;' (mayor que) se convierte en '&amp;gt;'
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Ntese que esta funcin no traduce nada ms que lo mostrado
     ms arriba. Para una traduccin de entidades completa, vea
     <function>htmlentities</function>.
    </para>
    <para>
     Vea tambin <function>htmlentities</function> y
     <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.implode">
   <refnamediv>
    <refname>implode</refname>
    <refpurpose>Unir elementos de una matriz mediante una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>implode</methodname>
      <methodparam><type>string</type><parameter>cola</parameter></methodparam>
      <methodparam><type>array</type><parameter>piezas</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena que contiene una representacin de todos los
     elementos de la matriz en el mismo orden, pero con la cadena
     <parameter>cola</parameter> en medio de los mismos.
     <example>
      <title>Ejemplo de <function>implode</function></title>
      <programlisting role="php">
$separada_dospuntos = implode (":", $matrizay);
      </programlisting>
     </example>
    </para>
    <simpara>
     Vea tambin <function>explode</function>, <function>join</function>,
     y <function>split</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.join">
   <refnamediv>
    <refname>join</refname>
    <refpurpose>Une elementos de una tabla mediante una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>join</methodname>
      <methodparam><type>string</type><parameter>cola</parameter></methodparam>
      <methodparam><type>array</type><parameter>piezas</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>join</function> es un alias para 
     <function>implode</function>, y es idntica en todo.
    </simpara>
    <simpara>
     Vea tambin <function>explode</function>, <function>implode</function>,
     y <function>split</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.levenshtein">
   <refnamediv>
    <refname>levenshtein</refname> 
    <refpurpose>
     Calcula la distancia Levenshtein entre dos cadenas
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin devuelve la distancia Levenshtein entre las dos
     cadenas argumento,  -1 si alguna de las cadenas tiene ms
     de 255 caracteres.
    </para>
    <para>
     La distancia Levenshtein se define como el mnimo nmero de
     caracteres que se tienen que sustituir, insertar o borrar
     para transformar <parameter>cad1</parameter> en
     <parameter>cad2</parameter>. La complejidad del algoritmo es
     <literal>O(m*n)</literal>, donde <literal>n</literal> y
     <literal>m</literal> son las longitudes de <parameter>cad1</parameter>
     y <parameter>cad2</parameter> (bastante bueno si se la compara con
     <function>similar_text</function>, que es O(max(n,m)**3), pero
     an es cara).
    </para>
    <para>
     Vea tambin <function>soundex</function>,
     <function>similar_text</function> y
     <function>metaphone</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ltrim">
   <refnamediv>
    <refname>ltrim</refname> 
    <refpurpose>
     Elimina el espacio en blanco del principio de una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>ltrim</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin elimina el espacio en blanco del principio de una
     cadena y devuelve la cadena resultante. Los caracteres de espacio
     que elimina realmente son: "\n", "\r", "\t", "\v", "\0",
     y el espacio en s.
    </para>
    <para>
     Vea tambin <function>chop</function> y <function>trim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.md5">
   <refnamediv>
    <refname>md5</refname>
    <refpurpose>Calcula el hash md5 de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>md5</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Calcula el hash (extracto) MD5 de <parameter>cad</parameter>
     usaneo el 
     <ulink url="&url.rfc;rfc1321.html">Algoritmo de Resumen de 
     Mensajes MD5 de RSA Data Security, Inc. </ulink>.
    </para>
        <para>
        Vea tambin: <function>crc32</function>
        </para>
   </refsect1>
  </refentry>

  <refentry id="function.metaphone">
   <refnamediv>
    <refname>metaphone</refname>
    <refpurpose>Calcula la clave "metfona" de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>metaphone</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Calcula la clave "metfona" de <parameter>cad</parameter>.
    </para>
    <para>
     Similarmente a <function>soundex</function>, metaphone crea la
     misma clave para palabras que suenan parecidas. Es ms precisa
     que la funcin <function>soundex</function>, pues conoce las
     reglas bsicas de la pronunciacin del Ingls. Las claves
     metafnicas generadas son de longitud variable.
    </para>
    <para>
     Metaphone fue desarrollado por Lawrence Philips
     &lt;lphilips@verity.com>. Se describe en ["Practical
     Algorithms for Programmers", Binstock &amp; Rex, Addison Wesley,
     1995].
     <note>
      <para>
       Esta funcin se aadi en PHP 4.0.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.nl2br">
   <refnamediv>
    <refname>nl2br</refname>
    <refpurpose>Convierte nuevas lneas a saltos de lnea HTML</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>nl2br</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la <parameter>cadena</parameter> con '&lt;BR&gt;' insertados
     antes de cada nueva lnea.
    </para>
    <para>
     Vea tambin <function>htmlspecialchars</function>,
     <function>htmlentities</function> y
     <function>wordwrap</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.ord">
   <refnamediv>
    <refname>ord</refname>
    <refpurpose>Devuelve el valor ASCII de un caracter</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>ord</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve el valor ASCII del primer caracter de 
     <parameter>cadena</parameter>. Esta funcin complementa a
     <function>chr</function>.
     <example>
      <title>Ejemplo de <function>ord</function></title>
      <programlisting role="php">
if (ord ($cad) == 10) {
    echo "El primer caracter de \$cad es un salto de lnea.\n";
}
      </programlisting>
     </example>
    </para>
    <simpara>
     Vea tambin <function>chr</function>.
    </simpara> 
   </refsect1>
  </refentry>

  <refentry id="function.parse-str">
   <refnamediv>
    <refname>parse_str</refname>
    <refpurpose>Divide la cadena en variables</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>void</type><methodname>parse_str</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Divide <parameter>cad</parameter> como si fuera la cadena de consulta
     enviada por un URL y crea las variables en el mbito actual.
    </para>
    <para>
     <example>
      <title>Usando <function>parse_str</function></title>
      <programlisting role="php">
$cad = "primero=valor&amp;segundo[]=esto+funciona&amp;segundo[]=otro";
parse_str($cad);
echo $primero;    /* escribe "valor" */
echo $segundo[0]; /* escribe "esto funciona" */
echo $segundo[1]; /* escribe "otro" */
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.print">
   <refnamediv>
    <refname>print</refname>
    <refpurpose>Emite una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <methodname>print</methodname>
      <methodparam><type>string</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Emite <parameter>arg</parameter>.
    </simpara>
    <simpara>
     Vea tambin: <function>echo</function>, <function>printf</function>,
     y <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.printf">
   <refnamediv>
    <refname>printf</refname>
    <refpurpose>Emite una cadena con formato</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>printf</methodname>
      <methodparam><type>string</type><parameter>formato</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Produce una salida segn el <parameter>formato</parameter>, que es
     descrito en la documentacin para <function>sprintf</function>.
    </simpara>
    <simpara>
     Vea tambin: <function>print</function>, <function>sprintf</function>, 
         <function>sscanf</function>, <function>fscanf</function>,
         y <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.quoted-printable-decode">
   <refnamediv>
    <refname>quoted_printable_decode</refname>
    <refpurpose>
     Convierte una cadena con marcacin imprimible a una cadena de 8 bits
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>quoted_printable_decode</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Esta funcin devuelve una cadena binaria de 8 bit que se corresponde
     con la cadena con marcacin imprimible decodificada. Esta funcin es
     similar a <function>imap_qprint</function>, pero sin requerir que el
     mdulo IMAP funcione.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.quotemeta">
   <refnamediv>
    <refname>quotemeta</refname>
    <refpurpose>Quote meta characters</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>quotemeta</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una versin de la cadena con una barra invertida
     (<literal>\</literal>) antes de cada caracter de este
     conjunto: <screen>. \\ + * ? [ ^ ] ( $ )</screen>
    </para>
    <simpara>
     Vea tambin <function>addslashes</function>,
     <function>htmlentities</function>, 
     <function>htmlspecialchars</function>, 
     <function>nl2br</function>, y 
     <function>stripslashes</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.rtrim">
   <refnamediv>
    <refname>rtrim</refname>
    <refpurpose>Elimina espacios en blanco al final de la cadena.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
     <type>string</type><methodname>rtrim</methodname>
     <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la cadena argumento sin espacios en blanco ni saltos
     de lnea al final. Es un alias para <function>chop</function>.
     <example>
      <title>Ejemplo de <function>rtrim</function></title>
      <programlisting role="php">
$recortada = rtrim ($linea);
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>trim</function>, <function>ltrim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sscanf">
   <refnamediv>
    <refname>sscanf</refname>
    <refpurpose>Trocea la entrada desde una cadena segn un formato dado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>mixed</type><methodname>sscanf</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam><type>string</type><parameter>formato</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
     </methodsynopsis>
    <para>
         La funcin<function>sscanf</function> es la funcin de entrada anloga
         de <function>printf</function>. <function>sscanf</function> lee del
         parmetro de cadena <parameter>cad</parameter> y lo interpreta segn el
         <parameter>formato</parameter> especificado. Si slo se pasan dos parmetros
         a esta funcin, los valores devueltos se harn en una matriz.
         <example>
         <title>Ejemplo de <function>sscanf</function></title>
         <programlisting role="php">
// obteniendo el nmero de serie
$numserie = sscanf("SN/2350001","SN/%d");
// y la fecha de fabricacin
$fecha = "01 Enero 2000";
list($dia, $mes, $anno) = sscanf($fecha,"%d %s %d");
echo "El objeto $numserie fue fabricado el: $anno-".substr($mes,0,3)."-$dia\n";
         </programlisting>
         </example>
         Si se pasan los parmetros opcionales, la funcin devolver el nmero de
         valores asignados. Los parmetros opcionales deben ser pasados por 
         referencia.
 <example>
         <title>Ejemplo de <function>sscanf</function> - usando parmetros opcionales</title>
         <programlisting role="php">
// obtener autor y generar la ficha DocBook
$autor = "24\tLewis Carroll";
$n = sscanf($autor,"%d\t%s %s", &amp;$id, &amp;$nombre, &amp;$apell);
echo "&lt;autor id='$id'&gt;
        &lt;firstname&gt;$nombre&lt;/firstname&gt;
        &lt;surname&gt;$apell&lt;/surname&gt;
&lt;/author&gt;\n";
         </programlisting>
         </example>
    </para>
    <para>
     Vea tambin: <function>fscanf</function>, <function>printf</function>,
     y <function>sprintf</function>. 
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.setlocale">
   <refnamediv>
    <refname>setlocale</refname>
    <refpurpose>Fija la informacin de localidad</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>setlocale</methodname>
      <methodparam><type>string</type><parameter>categoria</parameter></methodparam>
      <methodparam><type>string</type><parameter>localidad</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>categoria</parameter> es una cadena que especifica
     la categora de las funciones afectadas por el ajuste de localidad:
     <itemizedlist>
      <listitem>
       <simpara>
        LC_ALL para todas las funciones
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_COLLATE para la comparacin de cadenas - an no includa en el PHP
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_CTYPE para la conversin y clasificacin de caracteres, como por
        ejemplo <function>strtoupper</function>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_MONETARY para localeconv() - an no includa en el PHP
       </simpara>
      </listitem>
      <listitem>
       <simpara> 
        LC_NUMERIC para el separador decimal
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_TIME para el formato de fecha y hora con 
        <function>strftime</function>
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Si <parameter>localidad</parameter> es la cadena vaca
     <literal>""</literal>, los nombres de localidad se fijarn a 
     partir de las variables de entorno con los mismos nombres de las
     categoras anteriores, o desde "LANG".
    </para>
    <para>
     Si la localidad es cero o <literal>"0"</literal>, el ajuste de
     localidad no se ve afectado y slo se devuelve el ajuste actual.
    </para>
    <para>
     setlocale devuelve la nueva localidad, o &false; si la funcionalidad
     de localizacin no est disponible en la plataforma, la localidad
     especificada no existe o el nombre de categora no es vlido.
     Un nombre de categora no vlido tambin produce un mensaje de
     aviso.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.similar-text">
   <refnamediv>
    <refname>similar_text</refname>
    <refpurpose>
     Calcula la similitud entre dos cadenas
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>similar_text</methodname>
      <methodparam><type>string</type><parameter>primera</parameter></methodparam>
      <methodparam><type>string</type><parameter>segunda</parameter></methodparam>
      <methodparam choice="opt"><type>double</type><parameter>porcentaje</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin calcula la similitud entre dos cadenas segn se describe
     en Oliver [1993]. Ntese que esta implementacin no utiliza una pila
     como en el pseudo-cdigo de Oliver, sino llamadas recursivas que pueden
     o no acelerar el proceso completo. Ntese tambin que la complejidad
     de este algoritmo es O(N**3), donde N es la longitud de la cadena
     ms larga.
    </para>
    <para>
     Pasando una referencia como tercer argumento, 
     <function>similar_text</function> calcular para usted la similitud
     como porcentaje. Devuelve el nmero de caracteres coincidentes en
     ambas cadenas.
    </para>
   </refsect1>
  </refentry>
    
  <refentry id="function.soundex">
   <refnamediv>
    <refname>soundex</refname>
    <refpurpose>Calcula la clave soundex de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>soundex</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Calcula la clave soundex de <parameter>cad</parameter>.
    </para>
    <para>
     Las claves soundex tienen la propiedad de que las palabras que
     se pronuncian de forma parecida tienen la misma clave, de modo
     que se pueden usar para simplificar la bsqueda en las bases de
     datos cuando se conoce la pronunciacin pero no la transcripcin.
     Esta funcin soundex devuelve una cadena de 4 caracteres que
     comienza por una letra.
    </para>
    <para>
     Esta funcin soundex en particular es la descrita por Donald Knuth
     en "The Art Of Computer Programming, vol. 3: Sorting And
     Searching", Addison-Wesley (1973), pp. 391-392.
    </para>
    <para>
     <example>
      <title>Ejemplos de Soundex</title>
      <programlisting role="php">
soundex ("Euler") == soundex ("Ellery") == 'E460';
soundex ("Gauss") == soundex ("Ghosh") == 'G200';
soundex ("Knuth") == soundex ("Kant") == 'H416';
soundex ("Lloyd") == soundex ("Ladd") == 'L300';
soundex ("Lukasiewicz") == soundex ("Lissajous") == 'L222';
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sprintf">
   <refnamediv>
    <refname>sprintf</refname>
    <refpurpose>Devuelve una cadena con formato</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>sprintf</methodname>
      <methodparam><type>string</type><parameter>formato</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Devuelve una cadena producida de acuerdo a la cadena de 
     <parameter>formato</parameter>.
    </simpara>
    <simpara>
     La cadena de formato est compuesta por cero o ms directivas:
     caracteres ordinarios (excepto <literal>%</literal>) que son
     copiados directamente al resultado, y <emphasis>especificaciones
     de conversin</emphasis>, cada una de las cuales provoca la
     obtencin de su propio parmetro. Esto se aplica tanto a 
     <function>sprintf</function> como a <function>printf</function>.
    </simpara>
    <para>
     Cada especificacin de conversin consiste en uno de estos elementos,
     por orden:
     <orderedlist>
      <listitem>
       <simpara>
        Un <emphasis>especificador de relleno</emphasis> opcional que
        indica qu caracter se utilizar para rellenar el resultado hasta
        el tamao de cadena correcto. Este puede ser un espacio o un 
        <literal>0</literal> (caracter cero). El valor por defecto es
        rellenar con espacios. Un caracter de relleno alternativo se puede
        especificar prefijndolo con una comilla simple (<literal>'</literal>).
        Vea los ejemplos ms abajo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Un <emphasis>especificador de alineacin</emphasis> opcional que
        indica si el resultado debe ser alineado a la izquierda o a la
        derecha. Por defecto se alinea a la derecha; un caracter 
        <literal>-</literal> aqu lo justificar a la izquierda.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Un nmero opcional, un <emphasis>especificador de ancho</emphasis>
        que dice el nmero de caracteres (mnimo) en que debera resultar
        esta conversin.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Un <emphasis>especificador de precisin</emphasis> opcional que
        indica cuntos dgitos decimales deben mostrarse para los nmeros
        en coma flotante. Esta opcin no tienen efecto para otros tipos
        que no sean double. (Otra funcin til para formatear nmeros
        es <function>number_format</function>).
       </simpara>
      </listitem>
      <listitem>
       <para>
        Un <emphasis>especificador de tipo</emphasis> que indica el tipo
        a usar para tratar los datos de los argumentos. Los tipos posibles
        son:
        <simplelist>
         <member>
          <literal>%</literal> - un caracter literal de porcentaje. No se
          precisa argumento.
         </member>
         <member>
          <literal>b</literal> - el argumento es tratado como un entero y
          presentado como un nmero binario.
         </member>
         <member>
          <literal>c</literal> - el argumento es tratado como un entero, y
          presentado como el caracter con dicho valor ASCII.
         </member>
         <member>
          <literal>d</literal> - el argumento es tratado como un entero y
          presentado como un nmero decimal.
         </member>
         <member>
          <literal>f</literal> - el argumento es tratado como un doble y
          presentado como un nmero de coma flotante.
         </member>
         <member>
          <literal>o</literal> - el argumento es tratado como un entero, y
          presentado como un nmero octal.
         </member>
         <member>
          <literal>s</literal> - el argumento es tratado como una cadena y
          es presentado como tal.
         </member>
         <member>
          <literal>x</literal> - el argumento es tratado como un entero y
          presentado como un nmero hexadecimal (con minsculas).
         </member>
         <member>
          <literal>X</literal> - el argumento es tratado como un entero y
          presentado como un nmero hexadecimal (con maysculas).
         </member>
        </simplelist>
       </para>
      </listitem>
     </orderedlist>
    </para>
    <simpara>
     Vea tambin: <function>printf</function>, <function>sscanf</function>,
         <function>fscanf</function>, y <function>number_format</function>.
    </simpara>
   </refsect1>
   <refsect1>
    <title>Ejemplos</title>
    <para>
     <example>
      <title>Ejemplo de <function>sprintf</function>: enteros rellenos con ceros</title>
      <programlisting role="php">
$fechaiso = sprintf ("%04d-%02d-%02d", $anno, $mes, $dia);
      </programlisting>
     </example>
     <example>
      <title>Ejemplo de <function>sprintf</function>: formateando monedas</title>
      <programlisting role="php">
$pelas1 = 68.75;
$pelas2 = 54.35;
$pelas = $pelas1 + $pelas2;
// echo $pelas mostrar "123.1";
$formateado = sprintf ("%01.2f", $pelas);
// echo $formateado mostrar "123.10"
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strcasecmp">
   <refnamediv>
    <refname>strcasecmp</refname>
    <refpurpose>
     Comparacin de cadenas insensible a maysculas y minsculas
     y segura en modo binario
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strcasecmp</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve &lt; 0 si <parameter>cad1</parameter> es menor que
     <parameter>cad2</parameter>; &gt; 0 si <parameter>cad1</parameter>
     es mayor que <parameter>cad2</parameter>, y 0 si son iguales.
    <example>
      <title>Ejemplo de <function>strcasecmp</function></title>
      <programlisting role="php">
$var1 = "Hello";
$var2 = "hello";
if (!strcasecmp ($var1, $var2)) {
    echo '$var1 es igual a $var2 en una comparacin sin tener en cuenta '
     .'maysculas o minsculas';
}
      </programlisting>
    </example>
    </para>
    <simpara>
     Vea tambin <function>ereg</function>, <function>strcmp</function>,
     <function>substr</function>, <function>stristr</function>, y
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strchr">
   <refnamediv>
    <refname>strchr</refname> 
    <refpurpose>
     Encuentra la primera aparicin de un caracter
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strchr</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin es un alias para <function>strstr</function>, y es
     idntica en todo.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strcmp">
   <refnamediv>
    <refname>strcmp</refname>
    <refpurpose>Comparacin de cadenas con seguridad binaria</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strcmp</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Devuelve &lt; 0 si <parameter>cad1</parameter> es menor que
     <parameter>cad2</parameter>; &gt; 0 si <parameter>cad1</parameter>
     es mayor que <parameter>cad2</parameter>, y 0 si son iguales.
    </simpara>
    <simpara>
     Ntese que esta comparacin es sensible a maysculas y minsculas.
    </simpara>
    <simpara>
     Vea tambin <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strncmp</function>,
         y <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strcspn">
   <refnamediv>
    <refname>strcspn</refname>
    <refpurpose>
     Encuentra la longitud del elemento inicial que no coincide
     con la mscara
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strcspn</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Devuelve la longitud del segmento inicial de 
     <parameter>cad1</parameter> que <emphasis>no</emphasis>
     contiene ninguno de los caracteres de <parameter>cad2</parameter>.
    </simpara>
    <simpara>
     Vea tambin <function>strspn</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strip-tags">
   <refnamediv>
    <refname>strip_tags</refname>
    <refpurpose>Elimina marcas HTML y PHP de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strip_tags</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>etiq_permitidas</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin intenta eliminar todas las etiquetas HTML y PHP de
     la cadena dada. Causa error por precaucin en caso de etiquetas
     incompletas o falsas. Utiliza la misma mquina de estados para
     eliminar las etiquetas que la funcin <function>fgetss</function>.
    </para>
    <para>
     Puede usar el parmetro opcional para especificar las etiquetas
     que no deben eliminarse.
     <note>
      <para>
       <parameter>etiq_permitidas</parameter> fue aadido en PHP 3.0.13,
       PHP4B3.
      </para> 
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.stripcslashes">
   <refnamediv>
    <refname>stripcslashes</refname>
    <refpurpose>
     Desmarca la cadena marcada con <function>addcslashes</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>stripcslashes</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena con las barras invertidas eliminadas.
     Reconoce las marcas tipo C <literal>\n</literal>, 
     <literal>\r</literal> ..., y la representacin octal y
     hexadecimal.
     <note>
      <simpara>
       Aadida en PHP4b3-dev.
      </simpara>
     </note>
    </para>
    <simpara>
     Vea tambin <function>addcslashes</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.stripslashes">
   <refnamediv>
    <refname>stripslashes</refname>
    <refpurpose>
     Desmarca la cadena marcada con <function>addslashes</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>stripslashes</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve una cadena con las barras invertidas eliminadas
     (<literal>\'</literal> se convierte en <literal>'</literal>,
     etc.). Las barras invertidas dobles se convierten en sencillas.
    </para>
    <simpara>
     Vea tambin <function>addslashes</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.stristr">
   <refnamediv>
    <refname>stristr</refname>
    <refpurpose>
     <function>strstr</function> sin tener en cuenta
     maysculas o minsculas
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>stristr</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve todo el <parameter>pajar</parameter> desde la primera
     aparicin de la <parameter>aguja</parameter>, siendo el
     <parameter>pajar</parameter> examinado sin tener en cuenta
     maysculas o minsculas.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no se encuentra, devuelve
     &false;.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es una cadena, es convertida
     a entero y usada como cdigo de un carcter ASCII.
    </para>
    <para>
     Vea tambin <function>strchr</function>,
     <function>strrchr</function>, <function>substr</function>, y
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strlen">
   <refnamediv>
    <refname>strlen</refname>
    <refpurpose>Obtiene la longitud de la cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strlen</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la longitud de la <parameter>cadena</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strnatcmp">
   <refnamediv>
    <refname>strnatcmp</refname>
    <refpurpose>
    	Compara cadenas usando un algoritmo de "orden natural"
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strnatcmp</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <para>
         Esta funcin implementa un algoritmo de comparacin que ordena
         las cadenas alfanumricas como lo hara un ser humano, que es lo
         que se denomina "orden natural". A continuacin se puede ver un
         ejemplo de la diferencia entre este algoritmo y los algoritmos de
         ordenacin de cadenas habituales en los ordenadores (utilizados 
         en <function>strcmp</function>):
         <informalexample>
          <programlisting>
$matriz1 = $matriz2 = array ("img12.png","img10.png","img2.png","img1.png");
echo "Comparacin de cadenas estndar\n";
usort($matriz1,"strcmp");
print_r($matriz1);
echo "\nComparacin de cadenas en orden natural\n";
usort($matriz2,"strnatcmp");
print_r($matriz2);
          </programlisting>
         </informalexample>
         El cdigo anterior generar la siguiente salida:
         <informalexample>
          <programlisting>
Comparacin de cadenas estndar
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img10.png
    [2] =&gt; img12.png
    [3] =&gt; img2.png
)

Comparacin de cadenas en orden natural
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img2.png
    [2] =&gt; img10.png
    [3] =&gt; img12.png
)
          </programlisting>
         </informalexample>
         Para ms informacin, vea la pgina de Martin Pool sobre
         <ulink url="&url.strnatcmp;">Comparacin de Cadenas en
         Orden Natural</ulink>.
        </para>
        <simpara>
         De forma similar a otras funciones de comparacin de cadenas,
         esta devuelve &lt; 0 si <parameter>cad1</parameter> es menor que
         <parameter>cad2</parameter>; &gt; 0 si <parameter>cad1</parameter>
         es mayor que <parameter>cad2</parameter>, y 0 si son iguales.
    </simpara>
    <simpara>
     Ntese que esta comparacin es sensible a maysculas y minsculas.
    </simpara>
    <simpara>
     Vea tambin <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
     <function>strncmp</function>, <function>strnatcasecmp</function>,
         y <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strnatcasecmp">
   <refnamediv>
    <refname>strnatcasecmp</refname>
    <refpurpose>
         Comparacin de cadenas insensible a maysculas y minsculas
         usando un algoritmo de "orden natural"
        </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strnatcasecmp</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <para>
         Esta funcin implementa un algoritmo de comparacin que ordena
         las cadenas alfanumricas como lo hara un ser humano. El
         comportamiento de esta funcin es similar a
         <function>strnatcmp</function>, pero la comparacin no es 
         sensible a maysculas y minsculas. Para ms informacin,
         vea la pgina de Martin Pool sobre
         <ulink url="&url.strnatcmp;">Comparacin de Cadenas en
         Orden Natural</ulink>.
        </para>
        <simpara>
         De forma similar a otras funciones de comparacin de cadenas,
         esta devuelve &lt; 0 si <parameter>cad1</parameter> es menor que
         <parameter>cad2</parameter>; &gt; 0 si <parameter>cad1</parameter>
         es mayor que <parameter>cad2</parameter>, y 0 si son iguales.
    </simpara>
    <simpara>
     Vea tambin <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
     <function>strncmp</function>, <function>strnatcmp</function>,
         y <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>
 
  <refentry id="function.strncmp">
   <refnamediv>
    <refname>strncmp</refname>
    <refpurpose>
         Comparacin de los n primeros caracteres de cadenas, con
         seguridad binaria
        </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strncmp</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
      <methodparam><type>int</type><parameter>largo</parameter></methodparam>
     </methodsynopsis>
    <para>
    	 Esta funcin es similar a <function>strcmp</function>, con la 
    	 diferencia que se puede especificar el (lmite superior del)
    	 nmero de caractares (<parameter>largo</parameter>) de cada 
    	 cadena que se usarn en la comparacin. Si alguna de las cadenas
    	 es menor que el <parameter>largo</parameter>, se usar su
    	 longitud para la comparacin.
        </para>
        <simpara>
      
     Devuelve &lt; 0 si <parameter>cad1</parameter> es menor que
     <parameter>cad2</parameter>; &gt; 0 si <parameter>cad1</parameter>
     es mayor que <parameter>cad2</parameter>, y 0 si son iguales.
    </simpara>
    <simpara>
     Ntese que esta comparacin es sensible a maysculas y minsculas.
    </simpara>
    <simpara>
     Vea tambin <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
         y <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.str-pad">
   <refnamediv>
    <refname>str_pad</refname>
    <refpurpose>Rellena una cadena con otra hasta una longitud dada</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>str_pad</methodname>
      <methodparam><type>string</type><parameter>entrada</parameter></methodparam>
      <methodparam><type>int</type><parameter>tama_relleno</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>cad_relleno</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>tipo_relleno</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin rellena la cadena <parameter>entrada</parameter> por 
     la derecha, la izquierda o por ambos lados hasta el largo indicado.
     Si no se especifica el argumento opcional
     <parameter>cad_relleno</parameter>, <parameter>entrada</parameter>
     es rellenada con espacios. En caso contrario, ser rellenada con
     los caracteres de <parameter>cad_relleno</parameter> hasta el lmite.
    </para>

    <para>
     El argumento opcional <parameter>tipo_relleno</parameter> puede valer 
     STR_PAD_RIGHT, STR_PAD_LEFT, o STR_PAD_BOTH. Si no se especifica, se
     asume que vale STR_PAD_RIGHT.
    </para>
    
    <para>
      Si el valor de <parameter>tama_relleno</parameter> es negativo o menor
      que la longitud de la cadena de entrada, no se produce rellenado
      alguno.
    </para>

    <para>
     <example>
      <title>Ejemplo de <function>str_pad</function></title>
      <programlisting role="php">
$entrada = "Alien";
print str_pad($entrada, 10);                      // produce "Alien     "
print str_pad($entrada, 10, "-=", STR_PAD_LEFT);  // produce "-=-=-Alien"
print str_pad($entrada, 10, "_", STR_PAD_BOTH);   // produce "__Alien___"
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strpos">
   <refnamediv>
    <refname>strpos</refname>
    <refpurpose>
     Encuentra la posicin de la primera aparicin de una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strpos</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>desplazamiento</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la posicin numrica de la primera aparicin de la
     <parameter>aguja</parameter> en la cadena 
     <parameter>pajar</parameter>. A diferencia de 
     <function>strrpos</function>, esta funcin puede tomar una
     cadena completa como <parameter>aguja</parameter> y se utilizar
     en su totalidad.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es hayada, devuelve &false;.
     <note>
      <para>
       Es fcil confundir los valores de retorno para "caracter encontrado
       en la posicin 0" y "caracter no encontrado". Aqu se indica cmo
       detectar la diferencia:
       <informalexample>
        <programlisting role="php">
// en PHP 4.0b3 y posteriores:
$pos = strpos ($micadena, "b");
if ($pos === false) { // nota: tres signos igual
    // no encontrado ...
}

// en versiones anteriores a la 4.0b3:
$pos = strpos ($micadena, "b");
if (is_string ($pos) &amp;&amp; !$pos) {
    // no encontrado ...
}
        </programlisting>
       </informalexample>
      </para>
     </note>
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es una cadena, se convierte
     a entero y se aplica como el valor ordinal de un caracter.
    </para>
    <para>
     El parmetro opcional <parameter>desplazamiento</parameter> le permite
     especificar a partir de qu caracter del <parameter>pajar</parameter>
     comenzar a buscar. La posicin devuelta es an relativa al comienzo
     de <parameter>pajar</parameter>.
    </para>
    <para>
     Vea tambin <function>strrpos</function>,
     <function>strrchr</function>, <function>substr</function>,
     <function>stristr</function>, y <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strrchr">
   <refnamediv>
    <refname>strrchr</refname>
    <refpurpose>
     Encuentra la ltima aparicin de un caracter en una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strrchr</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin devuelve la porcin del 
     <parameter>pajar</parameter> que comienza en la ltima aparicin
     de la <parameter>aguja</parameter> y contina hasta el final
     del <parameter>pajar</parameter>.
    </para>
    <para>
     Devuelve &false; si la <parameter>aguja</parameter> no es hallada.
    </para>
    <para>
     Si la <parameter>aguja</parameter> contiene ms de un caracter,
     slo se usar el primero.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es una cadena, se convierte
     a entero y se aplica como el valor ordinal de un caracter.
     <example>
      <title>Ejemplo de <function>strrchr</function></title>
      <programlisting role="php">
// obtener el ltimo directorio de $PATH
$dir = substr (strrchr ($PATH, ":"), 1);

// obtener todo tras el ltimo salto de lnea
$texto = "Line 1\nLine 2\nLine 3";
$apell = substr (strrchr ($texto, 10), 1 );
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>substr</function>,
     <function>stristr</function>, y <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.str-repeat">
   <refnamediv>
    <refname>str_repeat</refname>
    <refpurpose>Repite una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>str_repeat</methodname>
      <methodparam><type>string</type><parameter>cad_entrada</parameter></methodparam>
      <methodparam><type>int</type><parameter>veces</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la <parameter>cad_entrada</parameter> repetida
     <parameter>veces</parameter>.
     <parameter>veces</parameter> debe ser mayor que 0.
    </para>
    <example>
     <title>Ejemplo de <function>str_repeat</function></title>
     <programlisting role="php">
echo str_repeat ("-=", 10);
     </programlisting>
    </example>
    <para>
     Esto mostrar "-=-=-=-=-=-=-=-=-=-=".
    </para>
    <note>
     <para>
      Esta funcin fue aadida en el PHP 4.0.
     </para> 
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.strrev">
   <refnamediv>
    <refname>strrev</refname>
    <refpurpose>Invierte una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strrev</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuele la <parameter>cadena</parameter> invertida.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strrpos">
   <refnamediv>
    <refname>strrpos</refname>
    <refpurpose>
     Encuentra la posicin de la ltima aparicin de un caracter en una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strrpos</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>char</type><parameter>aguja</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuele la posicin numrica de la ltima aparicin de
     la <parameter>aguja</parameter> en el <parameter>pajar</parameter>.
     Ntese que la aguja en este caso slo puede ser un caracter nico.
     Si se pasa una cadena como aguja, slo se utilizar el primer
     caracter de la misma.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es hayada, devuelve &false;.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es una cadena, se convierte
     a entero y se aplica como el valor ordinal de un caracter.
    </para>
    <para>
     Vea tambin <function>strpos</function>,
     <function>strrchr</function>, <function>substr</function>,
     <function>stristr</function>, y <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strspn">
   <refnamediv>
    <refname>strspn</refname>
    <refpurpose>
     Encuentra la longitud del segmento inicial que coincide con la
     mscara
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>strspn</methodname>
      <methodparam><type>string</type><parameter>cad1</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Devuelve la longitud del segmento inicial de 
     <parameter>cad1</parameter> que consiste por entero en
     caracteres contenidos en <parameter>cad2</parameter>.
    </simpara>
    <para>         
     <informalexample>
      <programlisting role="php">
strspn ("42 es la respuesta. Cul es la pregunta ...?", "1234567890");
      </programlisting>
      <para>
       devolver 2 como resultado.
      </para>
     </informalexample>
    </para>
    <simpara>
     Vea tambin <function>strcspn</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strstr">
   <refnamediv>
    <refname>strstr</refname>
    <refpurpose>Encuentra la primera aparicin de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strstr</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve todo el <parameter>pajar</parameter> desde la primera
     aparicin de la <parameter>aguja</parameter> hasta el final.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es hayada, devuelve &false;.
    </para>
    <para>
     Si la <parameter>aguja</parameter> no es una cadena, se convierte
     a entero y se aplica como el valor ordinal de un caracter.
    </para>
    <para>
     <note>
      <para>
       Ntese que esta funcin es sensible a maysculas y minsculas.
       Para bsquedas no sensibles, utilice <function>stristr</function>.
      </para>
     </note>
    </para>
    <para>
     <example>
      <title>Ejemplo de <function>strstr</function></title>
      <programlisting role="php">
$email = 'sterling@designmultimedia.com';
$dominio = strstr ($email, '@');
print $dominio; // imprime @designmultimedia.com
      </programlisting>
     </example> 
    </para>
    <para>
     Vea tambin <function>stristr</function>,
     <function>strrchr</function>, <function>substr</function>, y
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtok">
   <refnamediv>
    <refname>strtok</refname>
    <refpurpose>Divide una cadena en elementos</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strtok</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>string</type><parameter>arg2</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>strtok</function> se usa para dividir en elementos una
     cadena. Es decir, que si tiene una cadena como "Esta es una cadena
     de ejemplo" podra dividirla en palabras individuales utilizando
     el espacio como divisor.
     <example>
      <title>Ejemplo de <function>strtok</function></title>
      <programlisting role="php">
$cadena = "Esta es una cadena de ejemplo";
$tok = strtok ($cadena," ");
while ($tok) {
    echo "Palabra=$tok&lt;br>";
    $tok = strtok (" ");
}
      </programlisting>
     </example>
    </para>
    <para>
     Ntese que slo la primera llamada a strtok utiliza el argumento
     cadena. Cada llamada subsiguiente necesita slo el divisor a
     utilizar, puesto que ella guarda la posicin actual en la cadena.
     Para comenzar de nuevo o para dividir otra cadena, simplemente
     llame a strtok con el argumento de cadena y se inicializar.
     Ntese que puede poner divisores mltiples como parmetro. La
     cadena ser dividida cuando alguno de los caracteres del argumento
     sea hallado.
    </para>
    <para>
     Adems tenga cuidado si sus divisores valen "0", pues evala
     como &false; en las expresiones condicionales.
    </para>
    <para>
     Vea tambin <function>split</function> y
     <function>explode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtolower">
   <refnamediv>
    <refname>strtolower</refname>
    <refpurpose>Pasa a minsculas una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strtolower</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la <parameter>cadena</parameter> con todas sus letras
     en minsculas.
    </para>
    <para>
     Ntese que las letras son definidad por el locale actual. Esto
     quiere decir que, por ejemplo, en el locale por defecto ("C"),
     los caracteres como la  no sern convertidos.
    </para>
    <example>
     <title>Ejemplo de <function>strtolower</function></title>
     <programlisting role="php">
$cad = "Mara Tena Un Corderito al que QUERA Mucho";
$cad = strtolower($cad);        
print $cad; # Visualiza mara tena un corderito al que quera mucho
     </programlisting>
    </example>
    <para>
     Vea tambin <function>strtoupper</function>
     y <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtoupper">
   <refnamediv>
    <refname>strtoupper</refname>
    <refpurpose>Pasa a maysculas una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strtoupper</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
     </methodsynopsis>
    <para>
     Devuelve la <parameter>cadena</parameter> con todas sus letras
     en maysculas.
    </para>
    <para>
     Ntese que las letras son definidad por el locale actual. Esto
     quiere decir que, por ejemplo, en el locale por defecto ("C"),
     los caracteres como la  no sern convertidos.
    </para>
    <example>
     <title>Ejemplo de <function>strtoupper</function></title>
     <programlisting role="php">
$cad = "Mara Tena Un Corderito al que QUERA Mucho";
$cad = strtoupper ($cad);       
print $cad; # Visuaiza MARA TENA UN CORDERITO AL QUE QUERA MUCHO
     </programlisting>
    </example>
    <para>
     Vea tambin <function>strtolower</function>
     and <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.str-replace">
   <refnamediv>
    <refname>str_replace</refname>
    <refpurpose>
     Sustitiye todas las apariciones de la aguja en el pajar por la cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>str_replace</methodname>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin sustituye todas las apariciones de la 
     <parameter>aguja</parameter> en el <parameter>pajar</parameter>
     por la <parameter>cad</parameter> dada. Si no precisa reglas
     especiales de sustitucin, deber usar siempre esta funcin en
     lugar de <function>ereg_replace</function>.</para>
    <para>
     <example>
      <title>Ejemplo de <function>str_replace</function></title>
      <programlisting role="php">
$bodytag = str_replace ("%cuerpo%", "negro", "&lt;body text=%cuerpo%>");
      </programlisting>
     </example>
    </para>
    <para>
     Esta funcin tiene seguridad binaria.
    </para>
    <note>
     <para>
      <function>str_replace</function> fue aadida en PHP 3.0.6, pero tuvo
      errores hasta el PHP 3.0.8.
     </para>
    </note>
    <para>
     Vea tambin <function>ereg_replace</function> y
     <function>strtr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtr">
   <refnamediv>
    <refname>strtr</refname>
    <refpurpose>Traduce ciertos caracteres</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>strtr</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam><type>string</type><parameter>desde</parameter></methodparam>
      <methodparam><type>string</type><parameter>hasta</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin trabaja sobre <parameter>cad</parameter>, traduciendo
     todas las apariciones de cada caracter en <parameter>desde</parameter>
     por el caracter correspondiente en <parameter>hasta</parameter> y
     devolviendo el resultado.
    </para>
    <para>
     Si <parameter>desde</parameter> y <parameter>hasta</parameter> son
     de distinta longitud, los caracteres extra en la ms larga son
     ignorados.
     <example>
      <title>Ejemplo de <function>strtr</function></title>
      <programlisting role="php">
$addr = strtr($addr, "", "aao");
      </programlisting>
     </example>
    </para>
    <para>
     <function>strtr</function> puede llamarso slo con dos argumentos.
     Si se llama de esta manera, se comporta de otro modo:
     <parameter>desde</parameter> debe ser entonces una matriz que
     contenga pares cadena -> cadena que sern sustitudos en la
     cadena fuente. <function>strtr</function> siempre buscar la
     coincidencia ms larga primero y *NO* intentar sustituir nada
     en lo que haya trabajado ya.
    </para>
    <para>
     Ejemplos:
     <informalexample>
      <programlisting role="php">
$trad = array ("hola" =&gt; "hey", "hey" =&gt; "hola");
echo strtr("hey a todos, dije hola", $trad) . "\n";
      </programlisting>
     </informalexample>
     Mostrar: "hola a todos, dije hey",
    </para>
    <note>
     <simpara>
      Esta caracterstica (2 argumentos) fue aadida en el PHP 4.0
     </simpara>
    </note>
    <para>
     Vea tambin <function>ereg_replace</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.substr">
   <refnamediv>
    <refname>substr</refname>
    <refpurpose>Devuelve parte de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>substr</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
      <methodparam><type>int</type><parameter>comienzo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>largo</parameter></methodparam>
     </methodsynopsis>
    <para>
     substr devuelve la porcin de <parameter>cadena</parameter>
     especificada por los parmetros <parameter>comienzo</parameter>
     y <parameter>largo</parameter>.
    </para>
    <para>
     Si <parameter>comienzo</parameter> es positivo, la cadena devuelta
     comenzar en dicho caracter de <parameter>cadena</parameter>.
    </para>  
    <para>
     Ejemplos:
     <informalexample>
      <programlisting role="php">
$resto = substr ("abcdef", 1);    // devuelve "bcdef"
$resto = substr ("abcdef", 1, 3); // devuelve "bcd"
      </programlisting>
     </informalexample>
    </para>
    <para>
     Si <parameter>comienzo</parameter> es negativo, la cadena devuelta
     comenzar en dicha posicin desde el final de
     <parameter>cadena</parameter>.
    </para>
    <para>
     Ejemplos:
     <informalexample>
      <programlisting role="php">
$resto = substr ("abcdef", -1);    // devuelve "f"
$resto = substr ("abcdef", -2);    // devuelve "ef"
$resto = substr ("abcdef", -3, 1); // devuelve "d"
      </programlisting>
     </informalexample>
    </para>
    <para>
     Si se especifica <parameter>largo</parameter> y es positivo, la
     cadena devuelta terminar <parameter>largo</parameter> caracteres
     tras el <parameter>comienzo</parameter>. Si esto resulta en una 
     cadena con longitud negativa (porque el comienzo est pasado el
     final de la cadena), la cadena devuelta contendr nicamente el
     caracter que haya en <parameter>comienzo</parameter>.
    </para>
    <para>
     Si se especifica <parameter>largo</parameter> y es negativo, la
     cadena devuelta terminar a <parameter>largo</parameter> caracteres
     desde el final de <parameter>cadena</parameter>. Si esto resulta en una 
     cadena con longitud negativa, la cadena devuelta contendr 
     nicamente el caracter que haya en <parameter>comienzo</parameter>.
    </para>
    <para>
     Examples:
     <informalexample>
      <programlisting role="php">
$resto = substr ("abcdef", 1, -1); // devuelve "bcde"
      </programlisting>
     </informalexample>
    </para>
    <para>
     Vea tambin <function>strrchr</function> y
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.substr-count">
   <refnamediv>
    <refname>substr_count</refname>
    <refpurpose>Cuenta el nmero de apariciones de la subcadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>int</type><methodname>substr_count</methodname>
      <methodparam><type>string</type><parameter>pajar</parameter></methodparam>
      <methodparam><type>string</type><parameter>aguja</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr_count</function> devuelve el nmero de veces
     que la subcadena <parameter>aguja</parameter> se encuentra en
     la cadena <parameter>pajar</parameter>.
    </para>

    <para>
     <example>
      <title>Ejemplo de <function>substr_count</function></title>
      <programlisting>
print substr_count("This is a test", "is"); // prints out 2
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.substr-replace">
   <refnamediv>
    <refname>substr_replace</refname>
    <refpurpose>Sustituye texto en una parte de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>substr_replace</methodname>
      <methodparam><type>string</type><parameter>cadena</parameter></methodparam>
      <methodparam><type>string</type><parameter>sustituto</parameter></methodparam>
      <methodparam><type>int</type><parameter>comienzo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>largo</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr_replace</function> sustituye la parte de
     <parameter>cadena</parameter> delimitada por los parmetros
     <parameter>comienzo</parameter> y (opcionalmente)
     <parameter>largo</parameter> por la cadena dada en 
     <parameter>sustituto</parameter>. Se devuelve el resultado.
    </para>
    <para>
     Si <parameter>comienzo</parameter> es positivo, la sustitucin
     comenzar en dicha posicin dentro de la <parameter>cadena</parameter>.  
    </para>
    <para>
     Si <parameter>comienzo</parameter> es negativo, la sustitucin 
     comenzar en dicha posicin pero contando desde el final de
     <parameter>cadena</parameter>.  
    </para>
    <para>
     Si se especifica el <parameter>largo</parameter> y es positivo,
     representa el largo de la porcin de 
     <parameter>cadena</parameter> a sustituir. Si es negativo,
     representa el nmero de caracteres desde el final de
     <parameter>cadena</parameter> en los que dejar de sustituir.
     Si no se especifica, valdr por defecto 
     strlen(<parameter>cadena</parameter>); es decir, que acabar
     la sustitucin al final de <parameter>cadena</parameter>.
    </para>
    <para>
     <example>
      <title>Ejemplo de <function>substr_replace</function></title>
      <programlisting role="php">
&lt;?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var&lt;hr&gt;\n";

/* Estos dos ejemplos sustituyen toda $var por 'bob'. */
echo substr_replace ($var, 'bob', 0) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "&lt;br&gt;\n";

/* Inserta 'bob' justo al inicio de $var. */
echo substr_replace ($var, 'bob', 0, 0) . "&lt;br&gt;\n";

/* Los dos siguientes cambian 'MNRPQR' en $var por 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', -7, -1) . "&lt;br&gt;\n";

/* Borrar 'MNRPQR' de $var. */
echo substr_replace ($var, '', 10, -1) . "&lt;br&gt;\n";
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>str_replace</function> y
     <function>substr</function>.
    </para>
    <note>
     <simpara>
      <function>substr_replace</function> fue aadida en el PHP 4.0.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.trim">
   <refnamediv>
    <refname>trim</refname> 
    <refpurpose>
     Elimina espacios del principio y final de una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>trim</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funcin elimina los espacios en blanco del comienzo y del
     final de una cadena y devuelve el resultado. Los caracteres de
     espacio que elimina realmente son: "\n", "\r", "\t", "\v", "\0",
     y el espacio en s.
    </para>
    <para>
     Vea tambin <function>chop</function> y
     <function>ltrim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ucfirst">
   <refnamediv>
    <refname>ucfirst</refname> 
    <refpurpose>Pasar a maysculas el primer caracter de una cadena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>ucfirst</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pone en maysculas el primer carcter de <parameter>cad</parameter>
     si es alfabtico.
    </para>
    <para>
     Ntese que 'alfabtico' est determinado por la localidad actual.
     Por ejemplo, en la localidad por defecto "C", los caracteres como
     la a con diresis () no sern convertidos.
     <example>
      <title>Ejemplo de <function>ucfirst</function></title>
      <programlisting role="php">    
$texto = 'susanita tiene un ratn, un ratn chiquitn.';
$texto = ucfirst ($texto); // $texto vale ahora: Susanita tiene un
			// ratn, un ratn chiquitn.
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>strtoupper</function> y
     <function>strtolower</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ucwords">
   <refnamediv>
    <refname>ucwords</refname> 
    <refpurpose>
     Pone en maysculas el primer caracter de cada palabra 
     de una cadena
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>ucwords</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pasa a maysculas la primera letra de cada palabra en
     <parameter>cad</parameter> si dicho caracter es alfabtico.
     <example>
      <title>Ejemplo de <function>ucwords</function></title>
      <programlisting role="php">
$texto = "susanita tiene un ratn, un ratn chiquitn.";
$texto = ucwords($texto); // $texto vale ahora: Susanita Tiene Un
                        // Ratn, Un Ratn Chiquitn.
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambin <function>strtoupper</function>,
     <function>strtolower</function> y <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.wordwrap">
   <refnamediv>
    <refname>wordwrap</refname>
    <refpurpose>
     Corta una cadena en un nmero dado de caracteres usando un
     caracter de ruptura de cadenas.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripcin</title>
     <methodsynopsis>
      <type>string</type><methodname>wordwrap</methodname>
      <methodparam><type>string</type><parameter>cad</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>ancho</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>ruptura</parameter></methodparam>
     </methodsynopsis>
    <para>
     Corta la cadena <parameter>cad</parameter> en la columna 
     especificada por el parmetro (opcional) <parameter>ancho</parameter>.
     La lnea se rompe utilizando el parmetro (opcional)
     <parameter>ruptura</parameter>.
    </para>
    <para>
     <function>wordwrap</function> automticamente cortar en la
     columna 75 y usar '\n' (nueva lnea) si no se especifican
     el <parameter>ancho</parameter> o la <parameter>ruptura</parameter>.
    </para>
    <para>
     <example>
      <title>Ejemplo de <function>wordwrap</function></title>
      <programlisting role="php">
$texto = "El veloz murcilago hind coma feliz cardillo y kiwi.";
$textonuevo = wordwrap( $texto, 20 );

echo "$textonuevo\n";
      </programlisting>
     </example>
    </para>
    <para>
     Este ejemplo mostrara:
    </para>
    <para>
     <informalexample>
      <programlisting>
El veloz murcilago 
hind coma feliz cardillo y kiwi.
      </programlisting>
     </informalexample>
    </para>
    <para>
     Vea tambin <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>


 </reference>

<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->