Escrever dados formatados para a string Compose uma string com o mesmo texto que seria impresso se o formato fosse usado no printf. Mas em vez de ser impressa, o conteúdo é armazenado como uma string C no buffer apontado por str. O tamanho do buffer deve ser grande o suficiente para conter toda a sequência resultante (veja snprintf para uma versão mais segura). Um caractere nulo de término é automaticamente anexado após o conteúdo. Após o parâmetro de formato, a função espera pelo menos tantos argumentos adicionais quanto for necessário para o formato. Parâmetros str Ponteiro para um buffer onde o C-string resultante é armazenado. O buffer deve ser grande o suficiente para conter a seqüência resultante. Formato C string que contém uma seqüência de formato que segue as mesmas especificações que o formato em printf (veja printf para detalhes). (Argumentos adicionais) Dependendo da seqüência de formato, a função pode esperar uma seqüência de argumentos adicionais, cada um contendo um valor a ser usado para substituir um especificador de formato na seqüência de formato (ou um ponteiro para um local de armazenamento, para n). Deve haver pelo menos tantos desses argumentos como o número de valores especificados nos especificadores de formato. Argumentos adicionais são ignorados pela função. Valor de retorno No sucesso, o número total de caracteres escritos é retornado. Esta contagem não inclui o carácter nulo adicional automaticamente anexado no final da string. Na falha, um número negativo é retornado. Snprintf Escreva a saída formatada para o buffer de tamanho (função) printf Imprimir dados formatados para stdout (função) sscanf Ler dados formatados de string (função) Imprimir dados formatados para stdout Grava a string C apontada pelo formato para a saída padrão (stdout). Se o formato incluir especificadores de formato (subseqüências começando com), os argumentos adicionais que seguem o formato são formatados e inseridos na seqüência resultante, substituindo os respectivos especificadores. Os parâmetros formam a seqüência C que contém o texto a ser escrito para stdout. Ele pode opcionalmente conter especificadores de formato incorporado que são substituídos pelos valores especificados em argumentos adicionais subseqüentes e formatados conforme solicitado. Onde o caractere do especificador no final é o componente mais significativo, uma vez que define o tipo e a interpretação do seu argumento correspondente: inteiro digerido assinado inteiro decimal não assinado inteiro hexadecimal não assinado inteiro hexadecimal não assinado (maiúsculas) ponto decimal decimal, minúsculo ponto decimal decimal, Maiúsculas e minúsculas Notação científica (expoente da mantisa), minúsculas Notação científica (expoente da mantisa), maiúsculas Use a representação mais curta: e ou f Use a representação mais curta: E ou F Ponto flutuante hexadecimal, ponto flutuante hexadecimal em minúsculas, maiúsculas. O argumento correspondente deve ser um ponteiro para um int assinado. O número de caracteres escritos até agora é armazenado na localização apontada. Um seguido de outro personagem irá escrever um único no fluxo. O especificador de formato também pode conter sub-especificadores: sinalizadores. largura ..precisão e modificadores (nesse orden), que são opcionais e seguem estas especificações: Justificação da esquerda dentro do campo de campo especificado A justificação certa é o padrão (veja o subdiretor de largura). Força avançar o resultado com um sinal de mais ou menos (ou -) mesmo para números positivos. Por padrão, apenas os números negativos são precedidos de um sinal. Se nenhum sinal for escrito, um espaço em branco será inserido antes do valor. Usado com o. X ou X especificadores o valor é precedido com 0. 0x ou 0X respectivamente para valores diferentes de zero. Usado com um. UMA . E. E. F. F. G ou G força a saída escrita para conter um ponto decimal mesmo se não houver mais dígitos. Por padrão, se nenhum dígito seguir, nenhum ponto decimal é escrito. Alavanca esquerda o número com zero (0) em vez de espaços quando o preenchimento é especificado (veja o sub-especificador de largura). Para especificadores inteiros (d. I. O. U. X. X): precisão especifica o número mínimo de dígitos a serem escritos. Se o valor a ser escrito é menor do que este número, o resultado é preenchido com zeros avançados. O valor não é truncado, mesmo que o resultado seja maior. Uma precisão de 0 significa que nenhum caractere é escrito para o valor 0. Para um . UMA . E. E. Especificadores F e F: este é o número de dígitos a imprimir após o ponto decimal (por padrão, isto é 6). Para especificadores g e G: Este é o número máximo de dígitos significativos a serem impressos. Para s . Este é o número máximo de caracteres a serem impressos. Por padrão, todos os caracteres são impressos até que o caractere nulo final seja encontrado. Se o período for especificado sem um valor explícito para precisão. 0 é assumido. A precisão não é especificada na seqüência de formato, mas como um argumento de valor inteiro adicional que precede o argumento que deve ser formatado. O subdiretor de comprimento modifica o comprimento do tipo de dados. Este é um gráfico que mostra os tipos usados para interpretar os argumentos correspondentes com e sem especificador de comprimento (se um tipo diferente for usado, a promoção ou conversão de tipo apropriada será executada, se permitido): Nota sobre o especificador c: ele toma um int ( Ou wintt) como argumento, mas executa a conversão adequada para um valor de caracteres (ou um wchart) antes de formatá-lo para saída. Nota: linhas amarelas indicam especificadores e sub-especificadores introduzidos pelo C99. Veja ltcinttypesgt para os especificadores para tipos estendidos. . (Argumentos adicionais) Dependendo da seqüência de formato, a função pode esperar uma seqüência de argumentos adicionais, cada um contendo um valor a ser usado para substituir um especificador de formato na seqüência de formato (ou um ponteiro para um local de armazenamento, para n). Deve haver pelo menos tantos desses argumentos como o número de valores especificados nos especificadores de formato. Argumentos adicionais são ignorados pela função. Valor de retorno No sucesso, o número total de caracteres escritos é retornado. Se ocorrer um erro de escrita, o indicador de erro (ferror) é definido e um número negativo é retornado. Se um erro de codificação de caracteres multibyte ocorrer ao escrever caracteres largos, errno é configurado para EILSEQ e um número negativo é retornado. Compatibilidade As implementações particulares da biblioteca podem suportar especificadores adicionais e subdiretadores. Os listados aqui são suportados pelos últimos padrões C e C (ambos publicados em 2011), mas aqueles em amarelo foram introduzidos no C99 (apenas necessários para implementações C desde C11) e podem não ser suportados por bibliotecas que cumpram padrões mais antigos. Coloca a seqüência de gravação para stdout (função) scanf Leia dados formatados de stdin (função) fprintf Escreva dados formatados para transmitir (função) fwrite Escreva bloco de dados para transmitir funções (função): macro constantes:
No comments:
Post a Comment