Respostas:
snprintf () não gravará mais de <size> (argumento 2d do snprintf) no seu buffer, mas conta (e descarta os caracteres extras) que teria escrito, se houvesse espaço suficiente e esse é o número que retorna . Sim, pode ser confuso!
Veja esta referência snprintf () .
snprintf
um buffer muito pequeno, anote o número retornado e, em seguida, malloc
um buffer do tamanho apropriado e faça-o novamente. Dessa forma, você sabe quantos bytes alocar.
snprintf
armazenar nenhum buffer (um ponteiro de destino nulo é explicitamente descrito como um argumento válido para o caso destlength == 0) ao medir o comprimento.
Um esboço de teste para o Arduino Uno:
char buffer[10];
void setup() {
Serial.begin(9600);
int n = snprintf(buffer, 2, "hello");
Serial.println(n);
Serial.println(buffer);
}
void loop() {
}
Como o @JRobert escreveu, o "teria" é a chave. Até onde eu sei, apenas o snprintf e o vsnprintf retornam um número "teria".
Eu acho que o motivo é poder saber se a string foi truncada. Suponha que o parâmetro 'size' seja 25 e a sequência de formatação seja muito longa; o valor de retorno poderá ser testado em relação a 25. Se o valor de retorno for 26 (o número de bytes "teria"), a sequência de caracteres será truncada.
Não foi possível recuperar essas informações quando o número "teria" não estava disponível.
Para conclusão, a página de manual dos fprintf
estados:
A função snprintf () deve ser equivalente a sprintf (), com a adição do argumento n, que indica o tamanho do buffer referido por s. Se n for zero, nada deve ser escrito es pode ser um ponteiro nulo. Caso contrário, os bytes de saída além do n-1 serão descartados em vez de serem gravados na matriz, e um byte nulo será gravado no final dos bytes realmente gravados na matriz.
e, mais relevante:
Após a conclusão bem-sucedida, a função snprintf () retornará o número de bytes que seriam gravados em s se n fosse suficientemente grande, excluindo o byte nulo final.
asdf
contém "olá" ou "h"? Se ele contiver "h", o parâmetro não será ignorado.