repo_zf1/documentation/manual/de/module_specs/Zend_Validate-Isbn.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect2 id="zend.validate.set.isbn">
    <title>Isbn</title>

    <para>
        <classname>Zend_Validate_Isbn</classname> erlaubt es einen
        <acronym>ISBN-10</acronym> oder <acronym>ISBN-13</acronym> Wert zu prüfen.
    </para>

    <sect3 id="zend.validate.set.isbn.options">
        <title>Unterstützte Optionen für Zend_Validate_Isbn</title>

        <para>
            Die folgenden Optionen werden für <classname>Zend_Validate_Isbn</classname> unterstützt:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>separator</property></emphasis>: Definiert das erlaubte
                    Trennzeichen für die <acronym>ISBN</acronym> Nummer. Diese ist standardmäßig ein
                    leerer String.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><property>type</property></emphasis>: Definiert den erlaubten Typ an
                    <acronym>ISBN</acronym> Nummern. Dieser ist standardmäßig
                    <constant>Zend_Validate_Isbn::AUTO</constant>. Für Details sollte in
                    <link linkend="zend.validate.set.isbn.type-explicit">diesem Abschnitt</link>
                    nachgesehen werden.
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.isbn.basic">
        <title>Einfache Verwendung</title>

        <para>
            Ein einfaches Verwendungsbeispiel ist anbei zu finden:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Isbn();
if ($validator->isValid($isbn)) {
    // ISBN gültig
} else {
    // ISBN ungültig
}
]]></programlisting>

        <para>
            Das prüft jeden <acronym>ISBN-10</acronym> und <acronym>ISBN-13</acronym> Wert ohne
            Trennzeichen.
        </para>
    </sect3>

    <sect3 id="zend.validate.set.isbn.type-explicit">
        <title>Einen expliziten ISBN Prüfungstyp setzen</title>

        <para>
            Ein Beispiel für die Begrenzung auf einen <acronym>ISBN</acronym> Typ ist anbei zu
            finden:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Isbn();
$validator->setType(Zend_Validate_Isbn::ISBN13);
// ODER
$validator = new Zend_Validate_Isbn(array(
    'type' => Zend_Validate_Isbn::ISBN13,
));

if ($validator->isValid($isbn)) {
    // Das ist ein gültiger ISBN-13 Wert
} else {
    // Das ist ein ungültiger ISBN-13 Wert
}
]]></programlisting>

        <para>
            Das vorherige prüft nur auf <acronym>ISBN-13</acronym> Werte.
        </para>

        <para>
            Folgende gültige Typen sind vorhanden:
        </para>

        <itemizedlist>
            <listitem>
                <para><constant>Zend_Validate_Isbn::AUTO</constant> (default)</para>
            </listitem>

            <listitem>
                <para><constant>Zend_Validate_Isbn::ISBN10</constant></para>
            </listitem>

            <listitem>
                <para><constant>Zend_Validate_Isbn::ISBN13</constant></para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.isbn.separator">
        <title>Eine Begrenzung auf ein Trennzeichen spezifizieren</title>

        <para>
            Ein Beispiel für die Begrenzung auf ein Trennzeichen ist anbei zu finden:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Isbn();
$validator->setSeparator('-');
// ODER
$validator = new Zend_Validate_Isbn(array(
    'separator' => '-',
));

if ($validator->isValid($isbn)) {
    // Das ist eine gültige ISBN mit Trennzeichen
} else {
    // Das ist eine ungültige ISBN mit Trennzeichen
}
]]></programlisting>

        <note>
            <title>Werte ohne Trennzeichen</title>

            <para>
                Es ist zu beachten das dies <constant>FALSE</constant> zurückgibt wenn
                <varname>$isbn</varname> kein Trennzeichen <emphasis>oder</emphasis> einen
                ungültigen <acronym>ISBN</acronym> Wert enthält.
            </para>
        </note>

        <para>
            Gültige Separatoren sind:
        </para>

        <itemizedlist>
            <listitem><para>"" (Leer) (Standardwert)</para></listitem>
            <listitem><para>"-" (Bindestrich)</para></listitem>
            <listitem><para>" " (Leerzeichen)</para></listitem>
        </itemizedlist>
    </sect3>
</sect2>