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
            (
            <varname>$valor</varname>
            puede ser igual a una valor límite), aunque esto
            puede ser anulado a fin de hacer una
            comparación estricta, donde
            <varname>$valor</varname>
            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>