Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

sprintf — formatar texto para um buffer

sprintf escreve texto formatado num array de char. Não recebe o tamanho do buffer: o espaço tem de incluir também o '\0' final.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

sprintf de <stdio.h> escreve em s, não num fluxo. format especifica as conversões: %s espera uma cadeia de caracteres, %d um int e %% escreve %. Tipos de argumentos incompatíveis causam comportamento indefinido.

A saída termina com '\0'. A função devolve o número de caracteres escritos, sem contar este terminador, ou um valor negativo em caso de erro de codificação.

Um buffer demasiado pequeno e a cópia entre objetos sobrepostos causam comportamento indefinido. Verificar o valor devolvido não evita o transbordo. snprintf aceita um limite de tamanho e permite detetar o truncamento.

Exemplos

#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;
}

Resultado

x=42
count=4

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes