A função vsnprintf () em C ++ é usada para gravar uma string formatada em um buffer de string.
Ao contrário de vsprintf (), o número máximo de caracteres que podem ser gravados no buffer é especificado em vsnprintf().
protótipo vsnprintf ()
int vsnprintf (char * buffer, size_t buf_size, const char * formato, va_list vlist);
A vsnprintf()função grava a string apontada por formato em um buffer de string de caracteres. O número máximo de caracteres que podem ser escritos é buf_size. Depois que os caracteres são escritos, um caractere nulo de terminação é adicionado. Se buf_size for igual a zero, nada é escrito e buffer pode ser um ponteiro nulo.
O formato da string pode conter especificadores de formato começando com% que são substituídos pelos valores das variáveis que são passadas como uma lista vlist.
É definido no arquivo de cabeçalho.
Parâmetros vsnprintf ()
- buffer: Ponteiro para uma string de caracteres para escrever o resultado.
- buf_size: Número máximo de caracteres para escrever.
- formato: Ponteiro para uma string terminada em nulo que é gravada no fluxo de arquivos. Consiste em caracteres junto com especificadores de formato opcionais começando com%.
Os especificadores de formato são substituídos pelos valores das respectivas variáveis que seguem a string de formato.
O especificador de formato tem as seguintes partes:
- Um sinal% principal
- Sinalizadores: um ou mais sinalizadores opcionais que modificam o comportamento de conversão.
- -: Justificar à esquerda o resultado dentro do campo. Por padrão, é justificado à direita.
- +: O sinal do resultado é anexado ao início do valor, mesmo para resultados positivos.
- Espaço: Se não houver sinal, um espaço é anexado ao início do resultado.
- #: Uma forma alternativa de conversão é executada.
- 0: é usado para números inteiros e em ponto flutuante. Os zeros à esquerda são usados para preencher os números em vez de espaço.
- Largura: Um valor opcional * ou inteiro usado para especificar o campo de largura mínima.
- Precisão: um campo opcional que consiste em a. seguido por * ou inteiro ou nada para especificar a precisão.
- Comprimento: um modificador de comprimento opcional que especifica o tamanho do argumento.
- Especificador: um especificador de formato de conversão. Os especificadores de formato disponíveis são os seguintes:
Especificador de formato Descrição % Imprime% c Escreve um único personagem s Escreve uma string de caracteres d ou i Converte um inteiro com sinal em representação decimal o Converte um inteiro sem sinal em representação octal X ou x Converte um inteiro sem sinal em representação hexadecimal você Converte um inteiro sem sinal em representação decimal F ou F Converte o número de ponto flutuante em representação decimal E ou e Converte o número de ponto flutuante em notação de expoente decimal A ou a Converte o número de ponto flutuante em expoente hexadecimal G ou g Converte o número de ponto flutuante em notação de expoente decimal ou decimal n Retorna o número de caracteres escritos até agora por esta chamada para a função. O resultado é escrito no valor apontado pelo argumento p Grava uma sequência de caracteres definida pela implementação definindo um ponteiro. Portanto, o formato geral do especificador de formato é:
%(flags)(width)(.precision)(length)specifier
- vlist: uma lista de argumentos contendo os dados a serem gravados.
vsnprintf () Valor de retorno
- Se for bem-sucedida, a
vsnprintf()função retorna o número de caracteres gravados. - Em caso de falha, ele retorna um valor negativo.
- Quando o comprimento da string formatada é maior que buf_size, ela precisa ser truncada. Nesses casos, a
vsnprintf()função retorna o número total de caracteres excluindo o caractere nulo de terminação que teria sido escrito, se o limite buf_size não fosse imposto.
Exemplo: Como funciona a função vsnprintf ()
#include #include void write(char* buf, int buf_size, const char *fmt,… ) ( va_list args; va_start(args, fmt); vsnprintf(buf, buf_size, fmt, args); va_end(args); ) int main () ( char buffer(100); char fname(20) = "Bjarne"; char lname(20) = "Stroustrup"; char lang(5) = "C++"; write(buffer, 27, "%s was created by %s %s", lang, fname, lname); printf("%s", buffer); return 0; )
Quando você executa o programa, a saída será:
C ++ foi criado por Bjarne
