Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

sprintf — formater du texte dans un tampon

sprintf écrit du texte formaté dans un tableau de char. Elle ne reçoit pas la taille du tampon : l’espace doit aussi contenir le '\0' final.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdio.h>
int sprintf(char * restrict s, const char * restrict format, ...);

sprintf de <stdio.h> écrit dans s, et non dans un flux. format définit les conversions : %s attend une chaîne, %d un int, et %% écrit %. Des types d’arguments incompatibles entraînent un comportement indéfini.

La sortie se termine par '\0'. La fonction renvoie le nombre de caractères écrits, sans ce terminateur, ou une valeur négative en cas d’erreur d’encodage.

Un tampon trop petit et la copie entre des objets qui se chevauchent entraînent un comportement indéfini. Vérifier la valeur de retour ne prévient pas le dépassement. snprintf accepte une limite de taille et permet de détecter une troncature.

Exemples

#include <stdio.h>

int main(void)
{
    char buffer[16];
    int count = sprintf(buffer, "%s=%d", "x", 42);
    if (count < 0) {
        return 1;
    }
    printf("%s\ncount=%d\n", buffer, count);
    return 0;
}

Résultat

x=42
count=4

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources