NOM
ecvt, fcvt - Convertir des nombres réels en chaînes de caractères
SYNOPSIS
#include <stdlib.h>
char *ecvt(double number, int ndigits, int *decpt, int *sign);
char *fcvt(double number, int ndigits, int *decpt, int *sign);
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
ecvt(), fcvt() : _SVID_SOURCE || _XOPEN_SOURCE >= 500
La fonction ecvt() convertit number en une chaîne de caractères
terminée par un caractère nul, de ndigits chiffres (ndigits étant
limité par une valeur spécifique au système, déterminée par la
précision d’un double). La fonction renvoie un pointeur sur cette
chaîne. Le chiffre d’ordre le plus élevé est non nul, sauf si number
vaut zéro. Le chiffre d’ordre le plus faible est arrondi. La chaîne
elle-même ne contient pas de point décimal, néanmoins la position du
point décimal relativement au début de la chaîne est stockée dans
*decpt. Une valeur négative de *decpt signifie que le point décimal est
à gauche du début de la chaîne. Si le signe de number est négatif,
*sign est défini avec une valeur non nulle, sinon il est mis à 0. Si
number est nul, il n’est pas précisé si *decpt vaut zéro ou un.
La fonction fcvt() est identique à ecvt(), à la différence que ndigits
indique le nombre de décimales après la virgule.
VALEUR RENVOYÉE
Les deux fonctions ecvt() et fcvt() renvoient un pointeur sur une
chaîne de caractères statique contenant la représentation ASCII de
number. La chaîne statique est écrasée à chaque appel de ecvt() ou
fcvt().
CONFORMITÉ
SVr2, marqué comme « LEGACY » dans POSIX.1-2001. POSIX.1-2008 supprime
les spécifications de ecvt() et fcvt() et recommande à la place
l’utilisation de sprintf(3) (bien que snprintf(3) soit préférable).
NOTES
Les bibliothèques Linux, libc4 et libc5, déclaraient le type de ndigits
en size_t et certaines localisations n’utilisent pas le point comme
séparateur décimal.
VOIR AUSSI
ecvt_r(3), gcvt(3), qecvt(3), setlocale(3), sprintf(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
15 mars 2009