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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20301 -->
<!-- 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.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>