repo_zf1/documentation/manual/fr/module_specs/Zend_Mail-AddingRecipients.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.mail.adding-recipients">
    <title>Ajouter des destinataires</title>

    <para>
        Des destinataires peuvent être ajouter de trois façons :
    </para>

    <itemizedlist>
        <listitem>
            <para>
                <methodname>addTo()</methodname>: Ajoute un destinataire au courriel grâce
                à un en-tête "To"
            </para>
        </listitem>

        <listitem>
            <para>
                <methodname>addCc()</methodname>: Ajoute un destinataire au courriel grâce
                à un en-tête "Cc"
            </para>
        </listitem>

        <listitem>
            <para>
                <methodname>addBcc()</methodname>: Ajoute un destinataire non-visible
                dans les en-têtes du courriel
            </para>
        </listitem>
    </itemizedlist>

    <para>
        <methodname>getRecipients()</methodname> récupère la liste des destinataires.
        <methodname>clearRecipients()</methodname> efface la liste.
    </para>

    <note>
        <title>Paramètres additionnels</title>

        <para>
            <methodname>addTo()</methodname> et <methodname>addCc()</methodname> acceptent un
            second paramètre optionnel, qui est utilisé comme un nom de destinataire humainement
            lisible. Le guillemet double est changé en simple guillemet et les crochets en
            parenthèses dans le paramètre.
        </para>
    </note>

    <note>
        <title>Utilisation optionnelle</title>

        <para>
            Ces trois méthodes peuvent aussi accepter un tableau d'adresses mail plutôt que
            de les ajouter une par une. Dans le cas de <methodname>addTo()</methodname> et
            <methodname>addCc()</methodname>, il peut s'agir de tableaux associatifs où la clé
            est un nom de destinataire humainement lisible.
        </para>
    </note>
</sect1>