strfromd

NOM

strfromd, strfromf, strfroml - Convertir des nombres en virgule flottante en chaînes de caractères

BIBLIOTHÈQUE

Bibliothèque C standard ( libc, -lc)

SYNOPSIS

#include <stdlib.h>

int strfromd(char str[restrict .n], size_t n,
             const char *restrict format, double fp);
int strfromf(char str[restrict .n], size_t n,
             const char *restrict format, float fp);
int strfroml(char str[restrict .n], size_t n,
             const char *restrict format, long double fp);

strfromd(), strfromf(), strfroml() :

    __STDC_WANT_IEC_60559_BFP_EXT__

DESCRIPTION

Ces fonctions convertissent une valeur en virgule flottante, fp, en une chaîne de caractères, str, selon une chaîne configurable format. Au plus n caractères sont écrits dans str. The terminating null byte ('\0') is written if and only if n is sufficiently large, otherwise the written string is truncated at n characters. Les fonctions strfromd(), strfromf() et strfroml() sont équivalentes à :

snprintf(str, n, format, fp);

excepté pour la chaîne format.

CHAÎNE DE FORMAT

The format string must start with the character '%'. This is followed by an optional precision which starts with the period character (.), followed by an optional decimal integer. If no integer is specified after the period character, a precision of zero is used. Finally, the format string should have one of the conversion specifiers a, A, e, E, f, F, g, or G. L'indicateur de conversion est appliqué en se basant sur le type de virgule flottante indiqué par le suffixe de la fonction. Ainsi, et à la différence de snprintf(), la chaîne de formatage ne contient pas de caractère de modification de longueur. Consultez snprintf(3) pour une description détaillée de ces indicateurs de conversion. L'implémentation est conforme à la norme C99 concernant la conversion de NaN et de valeurs infinies : Une chaîne format malformée entraîne un comportement non défini.

VALEUR RENVOYÉE

The strfromd(), strfromf(), and strfroml() functions return the number of characters that would have been written in str if n had enough space, not counting the terminating null byte. Thus, a return value of n or greater means that the output was truncated.

VERSIONS

The strfromd(), strfromf(), and strfroml() functions are available since glibc 2.25.

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consultez attributes(7) et la section POSIX Safety Concepts dans le manuel de la Bibliothèque C GNU.

Interface	Attribut	Valeur
strfromd(), strfromf(), strfroml()	Sécurité des threads	MT-Safe locale
	Async-signal safety	AS-Unsafe heap
	Async-cancel safety	AC-Unsafe mem

Note : ces attributs sont préliminaires

STANDARDS

C99, ISO/IEC TS 18661-1.

NOTES

Les fonctions strfromd(), strfromf() et strfroml() prennent en compte la catégorie LC_NUMERIC de la locale utilisée.

EXEMPLES

Pour convertir la valeur 12.1 en tant que type flottant en une chaîne utilisant la notation décimale, résultant en « 12.100000 » :

#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromf(s, ssize, "%f", 12.1);

Pour convertir la valeur 12.3456 en tant que type flottant en une chaîne utilisant la notation décimale avec une précision de deux chiffres après la virgule, résultant en « 12.35 » :

#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromf(s, ssize, "%.2f", 12.3456);

Pour convertir la valeur 12.345e19 en tant que type double en une chaîne utilisant la notation scientifique avec aucun chiffre après la virgule, résultant en « 1E+20 » :

#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromd(s, ssize, "%.E", 12.345e19);

VOIR AUSSI

atof(3), snprintf(3), strtod(3)

TRADUCTION

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <[email protected]>, Thierry Vignaud <[email protected]>, François Micaux, Alain Portal <[email protected]>, Jean-Philippe Guérard <[email protected]>, Jean-Luc Coulon (f5ibh) <[email protected]>, Julien Cristau <[email protected]>, Thomas Huriaux <[email protected]>, Nicolas François <[email protected]>, Florentin Duneau <[email protected]>, Simon Paillard <[email protected]>, Denis Barbier <[email protected]>, David Prévot <[email protected]> et Grégoire Scano <[email protected]> Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à [email protected]