doc-fr/reference/strings/functions/echo.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.26 $ -->
<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
  <refentry xml:id="function.echo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <refnamediv>
    <refname>echo</refname>
    <refpurpose>Affiche une chaîne de caractères</refpurpose>
   </refnamediv>
   <refsect1>
    &reftitle.description;
     <methodsynopsis>
      <type>void</type><methodname>echo</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>...</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Affiche tous les paramètres.
    </simpara>
    <para>
     <function>echo</function> n'est pas vraiment une fonction (c'est
     techniquement une structure du langage), cela fait que vous n'êtes
     pas obligé d'utiliser des parenthèses. <function>echo</function>
     (contrairement à d'autres structures de langage) ne se comporte pas
     comme une fonction, il ne peut donc pas être utilisé dans le contexte d'une
     fonction. De même, si vous voulez passer plusieurs paramètres à
     <function>echo</function>, les paramètres ne doivent pas être entourrés
     de parenthèses.
     <example>
      <title>Exemples avec <function>echo</function></title>
      <programlisting role="php">
<![CDATA[
<?php
echo "Bonjour le monde";

echo "Cet echo() se
répartit sur plusieurs lignes. Il affiche aussi les
nouvelles lignes";

echo "Cet echo() se\nrépartit sur plusieurs lignes. Il affiche aussi les\nnouvelles lignes";

echo "L'échappement de caractères se fait : \"comme ceci\".";

// Vous pouvez utiliser des variables avec echo()
$foo = "foobar";
$bar = "barbaz";

echo "foo vaut \"$foo\""; // foo vaut "foobar"

// Vous pouvez aussi utiliser des tableaux
$bar = array("clé" => "foo");

echo "c'est {$bar['clé']} !"; // c'est foo !

// Les guillemets simples annulent le remplacement des variables
echo 'foo vaut $foo'; // foo vaut $foo

// Si vous n'utilisez pas d'autres caractères,
// vous pouvez afficher plusieurs variables
// en les séparant par des virgules
echo $foo;          // foobar
echo $foo,$bar;     // foobarbarbaz

// Des personnes préfèrent passer plusieurs
// paramètres en utilisant la concaténation
echo 'Cette ', 'chaîne ', 'a été ', 'faite ', 'avec plusieurs paramètres.', chr(10);
echo 'Cette ' . 'chaîne ' . 'a été ' . 'faite ' . 'à l\'aide de la concaténation.' . "\n";

echo <<<END
Cette syntaxe s'intitule le "here document" et
permet d'afficher plusieurs lignes avec de
l'interpolation de variables. Notez que la fin de
la syntaxe doit apparaître sur une nouvelle ligne,
avec uniquement un point-virgule, et pas d'espace
de plus !
END;

// parce que echo() ne se comporte pas comme une fonction, le code suivant n'est pas valide.
($some_var) ? echo('Oui') : echo('Non');

// Cependant, les lignes suivantes sont valides :
($some_var) ? print 'Oui' : print 'Non'; // print est aussi une structure de langage, mais
                                   // il se comporte comme une fonction, donc,
                                   // il peut être utilisé dans ce contexte.
echo $some_var ? 'Oui' : 'Non';
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <function>echo</function> dispose aussi d'une version courte,
     où vous pouvez faire suivre la balise &php; ouvrante d'un
     signe égal (<literal>=</literal>). Cette syntaxe n'est possible
     que si la directive de configuration <link
     linkend="ini.short-open-tag"><option>short_open_tag</option></link> a été activée.
     <example>
      <title>Afficher sans l'aide de <function>echo</function></title>
      <programlisting role="php">
<![CDATA[
J'ai <?=$foo?> fous.
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Pour une brève discussion à propos des différences
     entre <function>print</function> et <function>echo</function>,
     consultez cet article des <literal>FAQTs Knowledge Base</literal> : 
     <link xlink:href="&url.echo-print;">&url.echo-print;</link>
    </simpara>
    &note.language-construct;
    <simpara>
     Voir aussi
     <function>print</function>,
     <function>printf</function> et
     <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->