snprintf() dans la bibliothèque C
Le Fonction snprintf() est défini dans le fichier d'en-tête et est utilisé pour stocker la chaîne spécifiée jusqu'à une longueur spécifiée dans le format spécifié.
Caractéristiques de la méthode snprintf() :
- La fonction snprintf() formate et stocke une série de caractères et de valeurs dans le tampon du tableau.
- La fonction snprintf() accepte un argument « n », qui indique le nombre maximum de caractères (y compris à la fin du caractère nul) à écrire dans le tampon.
- La fonction snprintf() est utilisée pour rediriger la sortie de la fonction printf() vers un tampon.
- Le snprintf() renvoie également les caractères numériques qui étaient censés être écrits dans le tampon (à l'exclusion du terminateur nul), quelle que soit la valeur de « n » transmise.
- Ainsi, ce n'est que lorsque la valeur renvoyée est non négative et inférieure à « n » que la chaîne a été complètement écrite comme prévu.
Syntaxe: La syntaxe de la méthode snprintf() est :
int snprintf(char *str, size_t size, const char *format, …);
Paramètres:
- *str : est un tampon. size : est le nombre maximum d'octets (caractères) qui seront écrits dans le tampon. format : chaîne C qui contient une chaîne de format qui suit les mêmes spécifications que format dans printf … : le arguments facultatifs (…) ne sont que les formats de chaîne comme (%d, myint) comme on le voit dans printf.
Valeur de retour :
- Le nombre de caractères qui auraient été écrits dans le tampon, si « n » avait été suffisamment grand. Le caractère nul final n’est pas compté.
- Si une erreur d'encodage se produit, un nombre négatif est renvoyé.
Vous trouverez ci-dessous un exemple pour illustrer le fonctionnement de la méthode snprintf() :
Exemple 1:
C
// C program to demonstrate snprintf()> #include> int> main()> {> > char> buffer[50];> > char> * s => 'geeksforgeeks'> ;> > // Counting the character and storing> > // in buffer using snprintf> > printf> (> 'Writing %s onto buffer'> > ' with capacity 6'> ,> > s);> > int> j = snprintf(buffer, 6,> '%s
'> , s);> > // Print the string stored in buffer and> > // character count> > printf> (> '
String written on '> > 'buffer = %s'> , buffer);> > printf> (> '
Value returned by '> > 'snprintf() method = %d
'> , j);> > return> 0;> }> |
Sortir
Writing geeksforgeeks onto buffer with capacity 6 String written on buffer = geeks Value returned by snprintf() method = 14
Exemple 2 :
C
// C program to demonstrate snprintf()> #include> int> main()> {> > char> buffer[50];> > > // join two or more strings> > char> * str1 => 'quick'> ;> > char> * str2 => 'brown'> ;> > char> * str3 => 'lazy'> ;> > int> max_len => sizeof> buffer;> > int> j = snprintf(buffer, max_len,> > 'The %s %s fox jumped over the %s dog.'> ,> > str1, str2, str3);> > printf> (> '
The number of bytes printed to 'buffer' '> > '(excluding the null terminator) is %d
'> ,> > j);> > if> (j>= max_len)> > fputs> (> 'Buffer length exceeded; string truncated'> ,> > stderr);> > puts> (> 'Joined string:'> );> > puts> (buffer);> > return> 0;> }> |
Sortir
The number of bytes printed to 'buffer' (excluding the null terminator) is 45 Joined string: The quick brown fox jumped over the lazy dog.