repo_zf1/documentation/manual/es/module_specs/Zend_Validate-Set.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 19692 -->
<!-- Reviewed: no -->

<sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">

    <title>Clases de Validación Estándar</title>

    <para>Zend Framework viene con un conjunto estándar de clases de validación listas para usar.</para>

    <sect2 id="zend.validate.set.alnum">
        <title>Alnum</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname>
            contiene caracteres alfanuméricos únicamente. Este validador incluye una opción para
            considerar también al espacio en blanco como caracter válido.</para>
    </sect2>

    <note>
        <para>Los caracteres alfabéticos significan caracteres que componen palabras en cada
            idioma. Sin embargo, el alfabeto inglés es tratado como caracteres alfabéticos en los
            siguientes idiomas: chino, japonés, coreano. El lenguaje es especificado por
            Zend_Locale.</para>
    </note>


    <sect2 id="zend.validate.set.alpha">
        <title>Alpha</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> sólo
            contiene caracteres alfabéticos. Este validador incluye una opción para considerar
            también al espacio en blanco como caracter válido.</para>
    </sect2>

<xi:include href="Zend_Validate-Barcode.xml" />

    <sect2 id="zend.validate.set.between">
        <title>Between</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> está entre
            los valores límites mínimo y máximo. La comparación es inclusiva por defecto
                (<methodname>$valor</methodname> puede ser igual a una valor límite), aunque esto
            puede ser anulado a fin de hacer una comparación estricta, donde
                <methodname>$valor</methodname> debe ser estrictamente mayor al mínimo y
            estrictamente menor al máximo.</para>
    </sect2>

    <xi:include href="Zend_Validate-Callback.xml" />
    <xi:include href="Zend_Validate-CreditCard.xml" />
   
    <sect2 id="zend.validate.set.ccnum">
        <title>Ccnum</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> sigue el
            algoritmo Luhn (mod-10 checksum) para tarjetas de crédito.</para>
           
                    <note>
            <para>
                The <classname>Ccnum</classname> validator has been deprecated in favor of the
                <classname>CreditCard</classname> validator. For security reasons you should use
                CreditCard instead of Ccnum.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.validate.set.date">
        <title>Date</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> es una
            fecha válida en el formato <methodname>YYYY-MM-DD</methodname> (AAAA-MM-DD). Si se usa
            la opción <methodname>locale</methodname> entonces la fecha será validada de acuerdo a
            lo establecido para ese locale. Además, si se establece la opción
                <methodname>format</methodname> ese formato se utiliza para la validación. Para más
            detalles acerca de los parámetros opcionales ver en: <link
                linkend="zend.date.others.comparison.table">Zend_Date::isDate()</link>.</para>
    </sect2>

    <xi:include href="Zend_Validate-Db.xml">
        <xi:fallback href="../../en/module_specs/Zend_Validate-Db.xml"/>
    </xi:include>
    <sect2 id="zend.validate.set.digits">
        <title>Digits</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname>
            contiene solamente dígitos.</para>
    </sect2>

    <xi:include href="Zend_Validate-EmailAddress.xml">
        <xi:fallback href="../../en/module_specs/Zend_Validate-EmailAddress.xml"/>
    </xi:include>
    <sect2 id="zend.validate.set.float">
        <title>Float</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$value</varname> es un
            valor de punto flotante. Desde Zend Framework 1.8 toma en cuenta la localizacion actual
            del navegador, las variables o el uso. Puede usar get/setLocale para cambiar la
            configuracion regional o crear una instancia para este validador</para>
    </sect2>


    <sect2 id="zend.validate.set.greater_than">
        <title>GreaterThan</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> es
            mayor al límite mínimo.</para>
    </sect2>

    <sect2 id="zend.validate.set.hex">
        <title>Hex</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname>
            contiene caracteres hexadecimales (0-9 y A-F).</para>
    </sect2>


    <xi:include href="Zend_Validate-Hostname.xml"/>

    <sect2 id="zend.validate.set.iban">
        <title>Iban</title>
        <para>Returns <constant>TRUE</constant> if and only if <varname>$value</varname>
            contains a valid IBAN (International Bank Account Number). IBAN numbers are validated
            against the country where they are used and by a checksum.</para>
           
        <para>There are two ways to validate IBAN numbers. As first way you can give a locale which
            represents a country. Any given IBAN number will then be validated against this country.</para>
        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Iban('de_AT');
$iban = 'AT611904300234573201';
if ($validator->isValid($iban)) {
    // IBAN appears to be valid
} else {
    // IBAN is invalid
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}
]]></programlisting>
        <para>This should be done when you want to validate IBAN numbers for a single countries.
            The simpler way of validation is not to give a locale like shown in the next example.</para>
        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Iban();
$iban = 'AT611904300234573201';
if ($validator->isValid($iban)) {
    // IBAN appears to be valid
} else {
    // IBAN is invalid
}
]]></programlisting>
        <para>But this shows one big problem: When you have to accept only IBAN numbers from one
            single country, for example france, then IBAN numbers from other countries would also be
            valid. Therefor just remember: When you have to validate a IBAN number against a defined
            country you should give the locale. And when you accept all IBAN numbers regardless of
            any country omit the locale for simplicity.</para>
    </sect2>


    <sect2 id="zend.validate.set.in_array">
        <title>InArray</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> se
            encuentra en un array, y si la opción es estricta entonces también verificará el tipo de
            dato de <methodname>$valor</methodname>.</para>
    </sect2>

    <xi:include href="Zend_Validate-Identical.xml" />
    <xi:include href="Zend_Validate-InArray.xml" />
   
    <sect2 id="zend.validate.set.int">
        <title>Int</title>
        <para>
        Returns <constant>TRUE</constant> if and only if <varname>$value</varname> is a valid integer. Since
            Zend Framework 1.8 this validator takes into account the actual locale from browser,
            environment or application wide set locale. You can of course use the get/setLocale
            accessors to change the used locale or give it while creating a instance of this
            validator.</para>
    </sect2>

<xi:include href="Zend_Validate-Ip.xml" />

    <sect2 id="zend.validate.set.less_than">
        <title>LessThan</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> es
            menor al límite máximo.</para>
    </sect2>

    <sect2 id="zend.validate.set.not_empty">
        <title>NotEmpty</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname> no es
            vacío.</para>
    </sect2>

    <xi:include href="Zend_Validate-PostCode.xml" />
   
    <sect2 id="zend.validate.set.regex">
        <title>Regex</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si <varname>$valor</varname>
            coincide con el patrón de una expresión regular.</para>
    </sect2>

    <xi:include href="Zend_Validate-Sitemap.xml">
        <xi:fallback>
            <xi:include href="../../en/module_specs/Zend_Validate-Sitemap.xml"/>
        </xi:fallback>
    </xi:include>

    <sect2 id="zend.validate.set.string_length">
        <title>StringLength</title>
        <para>Devuelve <constant>TRUE</constant> si y sólo si la longitud del string
                <varname>$valor</varname> es por lo menos un mínimo y no mayor a un máximo
            (cuando la opción max no es <constant>NULL</constant>). Desde la versión 1.5.0, el
            método <methodname>setMin()</methodname> lanza una excepción si la longitud mínima tiene
            un valor mayor que la longitud máxima establecida, y el método
                <methodname>setMax()</methodname> lanza una excepción si la longitud máxima se fija
            a un valor inferior que la longitud mínima establecida. Desde la versión 1.0.2, esta
            clase soporta UTF-8 y a otras codificaciones, basado en el valor actual de: <ulink
                url="http://www.php.net/manual/en/ref.iconv.php#iconv.configuration">
                iconv.internal_encoding
            </ulink>.
            If you need a different encoding you can set it with the accessor methods getEncoding
             and setEncoding.
            </para>
    </sect2>

</sect1>