====== Quels sont les arguments contre l'utilisation d'“eqnarray”? ======

L'environnement ''eqnarray'' paraît attractif pour les utilisateurs occasionnels de mathématiques dans des documents <latex>\LaTeX</latex> : il semble permettre d'alignement de systèmes d'équations. 

==== ====
<WRAP column 45ex>
<code latex>
\documentclass{article}
\begin{document}
\begin{eqnarray}
  a & = & b + c \\
  x & = & y - z
\end{eqnarray}
\end{document}
</code>
</WRAP>
<WRAP column 45ex>
<latexdoc>
\documentclass{article}
\usepackage[body={8cm,8cm}]{geometry}
\usepackage{lmodern}
\pagestyle{empty}
\begin{document}
\begin{eqnarray}
  a & = & b + c \\
  x & = & y - z
\end{eqnarray}
\end{document}
</latexdoc>
</WRAP>
<WRAP clear />
===== =====

Et, en effet, il //fournit// cette fonctionnalité d'alignement... mais en gérant l'espacement de façon douteuse.

Ce sujet est discuté en détail dans un article en anglais du [[https://tug.org/pracjourn/2006-4/madsen/madsen.pdf|PracTeX journal paper]] de Lars Madsen; Stefan Kottwitz a également rédigé un [[http://texblog.net/latex-archive/maths/eqnarray-align-environment/|billet du TeX blog]] en anglais qui inclut des copies d'écran illustrant clairement les problèmes associés à ''eqnarray''. La présente page se limite à trois arguments importants.

===== L'espacement autour du symbole de relation =====

Typographiquement, ''eqnarray'' rajoute beaucoup d'espacement autour du symbole de relation, de façon injustifiée et incohérente avec les autres environnements mathématiques (ci-dessous ''equation'', ''eqnarray'' puis ''align'').

==== ====
<WRAP column 45ex>
<code latex>
\documentclass{article}
\usepackage{mathtools}
\begin{document}
\begin{equation*}
  x & = & y
\end{equation*}

\begin{eqnarray*}
  x & = & y
\end{eqnarray*}

\begin{align*}
  x & = y
\end{align*}
\end{document}
</code>
</WRAP>
<WRAP column 45ex>
<latexdoc>
\documentclass{article}
\usepackage[body={8cm,8cm}]{geometry}
\usepackage{mathtools}
\usepackage{lmodern}
\pagestyle{empty}
\begin{document}
\begin{equation*}
  x & = & y
\end{equation*}
\vspace*{-0.8cm}
\begin{eqnarray*}
  x & = & y
\end{eqnarray*}
\vspace*{-1cm}
\begin{align*}
  x & = y
\end{align*}
\end{document}
</latexdoc>
</WRAP>
<WRAP clear />
===== =====

De fait, dans l'environnement ''eqnarray'', les espaces autour du symbole « <latex>$=$</latex> » ne sont pas ceux définis par les métriques de la fonte. Ils sont définis par ''\arraycolsep'', qui peut être arbitrairement fixé à des valeurs utiles aux véritables tables présentes dans le document.   

===== La gestion du numéro d'équation =====

Quand l'équation occupe toute la largeur de la page, ''eqnarray'' ne s'en rend pas compte et place le numéro d'équation en surimpression sur le texte. Les autres environnements standard, comme equation, ne présentent pas ce problème et placent le tag en-dessous (pour les deux premières lignes ci-dessous, est utilisé ''eqnarray'' avec ''\setlength\arraycolsep{2pt}''; pour les deux suivantes, ''align'').

==== ====
<WRAP column 45ex>
<code latex>
\documentclass{article}
\usepackage{mathtools}
\begin{document}
\setlength\arraycolsep{2pt}
\begin{eqnarray}
  a & = & b \\
    & = & cdefghijklmnopqrst
          uvwxyzcdefghijklmno
\end{eqnarray}

\begin{align}
  a & = b \\
    & = cdefghijklmnopqrst
        uvwxyzcdefghijklmno
\end{align}
\end{document}
</code>
</WRAP>
<WRAP column 45ex>
<latexdoc>
\documentclass{article}
\usepackage[body={8cm,8cm}]{geometry}
\usepackage{mathtools}
\usepackage{lmodern}
\pagestyle{empty}
\begin{document}
\setlength\arraycolsep{2pt}
\begin{eqnarray}
  a & = & b \\
    & = & cdefghijklmnopqrst
          uvwxyzcdefghijklmno
\end{eqnarray}
\vspace*{-0.5cm}
\begin{align}
  a & = b \\
    & = cdefghijklmnopqrst 
        uvwxyzcdefghijklmno
\end{align}
\end{document}
</latexdoc>
</WRAP>
<WRAP clear />
===== =====

===== Le manque de comptabilité avec “amsmath” =====

Par ailleurs, ''eqnarray'' ne fonctionne pas correctement avec les commandes de l'extension [[ctanpkg>amsmath]], incontournable pour composer les mathématiques. Par exemple, les commandes ''\tag'' et ''\intertext'' fonctionnent avec tous les environnements sauf ''eqnarray''.

===== Ce qu'il existe pour la remplacer =====

==== L'environnement “align” ====

Pour ces raisons, ''eqnarray'' doit être considéré comme obsolète et ne plus être utiliser. Il est avantageusement remplacé par les environnements de [[ctanpkg>mathtools]] (ou de [[ctanpkg>amsmath]]), notamment ''align'' défini pour répondre aux besoins des mathématiciens dont voici la syntaxe pour corriger l'exemple ci-dessus:

=== ===
<WRAP column 45ex>
<code latex>
\documentclass{article}
\usepackage{mathtools}
\begin{document}
\begin{align}
  a & = b + c \\
  x & = y - z
\end{align}
\end{document}
</code>
</WRAP>
<WRAP column 45ex>
<latex>
\begin{align}
  a & = b + c \\
  x & = y - z
\end{align}
</latex>
</WRAP>
<WRAP clear />
==== ====

==== Un correctif ancien et partiel ====

<note important>Ce qui suit est informatif et n'est conservé que pour historiser la méthode. L'utilisation de l'environnement ''eqnarray'' n'étant pas recommandé, cette astuce ne l'est pas plus.</note>

Pour réduire les espaces entre les différentes colonnes d'un environnement ''eqnarray'', il suffit d'inclure la macro suivante dans le préambule de votre document :

=== ===
<code latex>
\makeatletter
\newlength{\earraycolsep}
\setlength{\earraycolsep}{2pt}

\def\eqnarray{\stepcounter{equation}%
  \let\@currentlabel%
  \theequation
  \global\@eqnswtrue\m@th
  \global\@eqcnt\z@\tabskip\@centering
  \let\\\@eqncr
  $$\halign to\displaywidth\bgroup\@eqnsel
  \hskip\@centering
  $\displaystyle\tabskip\z@{##}$&
  \global\@eqcnt\@ne\hskip 2\earraycolsep 
  \hfil$\displaystyle{##}$\hfil
  &\global\@eqcnt\tw@ \hskip 2\earraycolsep
  $\displaystyle\tabskip\z@{##}$\hfil
  \tabskip\@centering&\llap{##}\tabskip\z@\cr}
\makeatother
</code>
==== ====

-----
//Sources://
  * [[faquk>FAQ-eqnarray|Why not use “eqnarray”?]]
  * [[https://web.archive.org/web/20170314080827/https://elzevir.fr/imj/latex/tips.html#eqnarray|Trois arguments contre eqnarray]], par Manuel Pégourié-Gonnard.

{{htmlmetatags>metatag-keywords=(LaTeX,mathématiques,équations,alignement en mode mathématique,grande formule,alignement sur le signe égal,systèmes d'équation)
metatag-og:title=(Quels sont les arguments contre l'utilisation d'“eqnarray”)
metatag-og:site_name=(FAQ LaTeX francophone)
}}