Fonctions de bibliothèque C -snprintf()

Bibliothèque standard C - <stdio.h>

Description

snprintf() est une fonction de bibliothèque standard du langage C utilisée pour formater et produire une chaîne, et écrire le résultat dans un tampon spécifié. Contrairement à sprintf(), snprintf() limite le nombre de caractères produits pour éviter un débordement de tampon.

etsprintf()La différence est que la fonction snprintf() fournit un paramètre, size, qui peut empêcher un débordement de tampon. Si la longueur de la chaîne formatée dépasse size-1, snprintf() n'écrira que size-1 caractères et ajoutera un caractère nul (\0) à la fin de la chaîne pour marquer sa terminaison.

Déclaration

Ci-dessous se trouve la déclaration de la fonction snprintf().

int snprintf ( char * str, size_t size, const char * format, ... );

int snprintf(char *str, size_t size, const char *format, ...)Que les arguments variables soient définis(...)selonformatFormate en une chaîne et copie la chaîne versstrParmi eux,sizeLe nombre maximum de caractères à écrire ; s'il dépassesizeil sera tronqué, et au plus size-1 caractères seront écrits.

Paramètre

  • str-- La chaîne de destination, un pointeur vers un tableau de caractères utilisé pour stocker la chaîne formatée.
  • size-- la taille du tableau de caractères.
  • format-- la chaîne de format.
  • ...-- Arguments variables, un nombre variable d'arguments formatés selon les directives de formatage dans format.

Valeur de retour

La valeur de retour est un entier :

  • En cas de succès, renvoie le nombre de caractères qui auraient été écrits (en excluant le caractère nul de terminaison), même si cette valeur est supérieure à size.

  • Si une erreur d'encodage se produit, une valeur négative est renvoyée.

Exemple

L'exemple suivant montre l'utilisation de la fonction snprintf().

Exemple

#include <stdio.h>
 
int main()
{
    char buffer[50];
    char* s = "examplecom";
 
    // Lire la chaîne et la stocker dans buffer.
    int j = snprintf(buffer, 6, "%s\n", s);
 
    // Tampon de sortie et nombre de caractères.
    printf("chaîne :\n%s\nnombre de caractères = %d\n", buffer, j);
 
    return 0;
}

Le résultat de sortie est:

string:
runoo
character count = 10

Voici un exemple montrant comment utiliser%fLe spécificateur de format pour afficher un nombre à virgule flottante en simple précision dans snprintf() :

Exemple

#include <stdio.h>

int main() {
  char buffer[50];
  float x = 3.1415926;
  int len = snprintf(buffer, 50, "x = %f", x);
  printf("%s\n", buffer);
  printf("Caractères écrits : %d\n", len);
  return 0;
}

Le résultat de sortie est:

x = 3.141593
Written characters: 12

Dans l'exemple ci-dessus, snprintf() écrit la chaîne "x = 3.141593" dans le buffer et renvoie la longueur de la chaîne, qui est 12. Comme la taille du buffer est 50, il y aura un caractère nul à la fin de la chaîne. Enfin, le programme affiche la chaîne dans le buffer et le nombre de caractères renvoyé par snprintf().

Notes :

  • taille du buffer:snprintf()La fonction limite le nombre de caractères affichés, mais vous devez vous assurer que la taille du buffer transmis est suffisamment grande pour contenir la chaîne formatée. Sinon, la chaîne peut être tronquée, ce qui entraîne une perte d'informations.

  • Terminateur de chaîne:snprintf()La fonction ajoute un caractère nul à la fin du buffer comme terminateur de chaîne, mais ce caractère n'est pas compté dans la valeur de retour. Par conséquent, lorsque vous utilisezsnprintf()Lors de l'affichage d'une chaîne, vous devez vous assurer que la taille du buffer est suffisante pour contenir tous les caractères de la chaîne ainsi que le caractère nul final.

  • Chaîne de format: Lors de l'utilisation desnprintf()Lors du formatage d'une chaîne, vous devez vous assurer que les spécificateurs de format dans la chaîne de format correspondent aux types des arguments variables. Sinon, la sortie peut contenir des erreurs.

  • Valeur de retour:snprintf()La valeur de retour de la fonction est le nombre de caractères écrits dans le buffer, à l'exclusion du caractère nul à la fin de la chaîne. Si la valeur de retour est égale à la taille du buffer, cela indique que le résultat de sortie a été tronqué.

  • Arguments variables:snprintf()Les arguments variables de la fonction sont passés via...Cela signifie que les arguments variables doivent être passés en utilisant des types qui correspondent aux spécificateurs de format. Lors de l'utilisation d'arguments variables, vous devez éviter d'utiliser des variables non initialisées ; sinon, des résultats imprévisibles peuvent se produire.

En résumé, lorsque vous utilisez la fonction snprintf(), vous devez faire attention à des problèmes tels que la taille du tampon, le terminateur de chaîne, la chaîne de format, la valeur de retour et les arguments variables, afin de garantir que le résultat de sortie est correct.

Bibliothèque standard C - <stdio.h>

autres extensions