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

From: Date: Sat, 04 Dec 2010 16:52:45 +0000
Subject: svn: /phpdoc/es/trunk/reference/strings/functions/ strstr.xml
Groups: php.doc.es 
Request: Send a blank email to doc-es+get-3851@lists.php.net to get a copy of this message
yago Sat, 04 Dec 2010 16:52:45 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=305965 Log: updated to the most recent version. Changed paths: A phpdoc/es/trunk/reference/strings/functions/strstr.xml Added: phpdoc/es/trunk/reference/strings/functions/strstr.xml =================================================================== --- phpdoc/es/trunk/reference/strings/functions/strstr.xml (rev 0) +++ phpdoc/es/trunk/reference/strings/functions/strstr.xml 2010-12-04 16:52:45 UTC (rev 305965) @@ -0,0 +1,166 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision$ --> +<!-- EN-Revision: 297028 Maintainer: yago Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strstr"> + <refnamediv> + <refname>strstr</refname> + <refpurpose>Buscar la primera aparición de una cadena</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strstr</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>before_needle</parameter><initializer>false</initializer></methodparam> + </methodsynopsis> + <para> + Devuelve parte de la cadena <parameter>pajar</parameter> desde la primera + aparición de la <parameter>aguja</parameter> hasta el final del + <parameter>pajar</parameter>. + </para> + <note> + <para> + Esta función es sensible a mayúsculas. Para búsquedas sin importar las mayúsculas, use + <function>stristr</function>. + </para> + </note> + <note> + <para> + Si solo se quiere saber si una <parameter>aguja</parameter> determinada, + aparece en un <parameter>pajar</parameter>, use la función <function>strpos</function> + ya que es más rápida y utiliza menos memoria. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>pajar</parameter></term> + <listitem> + <para> + La cadena en donde buscar. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>aguja</parameter></term> + <listitem> + <para> + Si la <parameter>aguja</parameter> no es una cadena, será convertida + como número entero y se aplicará el valor ordinal de caracter. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>before_needle</parameter></term> + <listitem> + <para> + Si se define como &true;, <function>strstr</function> devolverá + la parte del <parameter>pajar</parameter> antes de la primera + ocurrencia de la <parameter>aguja</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Devuelve una parte de una cadena o &false; si no se encuentra la + <parameter>aguja</parameter>. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.3.0</entry> + <entry> + Se añadió el parámetro opcional <parameter>before_needle</parameter>. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + <function>strstr</function> se hizo segura binariamente. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ejemplo de <function>strstr</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$email = 'name@example.com'; +$domain = strstr($email, '@'); +echo $domain; // mostrará @example.com + +$user = strstr($email, '@', true); // Desde PHP 5.3.0 +echo $user; // mostrará name +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>stristr</function></member> + <member><function>strpos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> Property changes on: phpdoc/es/trunk/reference/strings/functions/strstr.xml ___________________________________________________________________ Added: svn:keywords + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL Added: svn:eol-style + native

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