printf_s, _printf_s_l, wprintf_s, _wprintf_s_l
Formatados saída de impressão para o fluxo de saída padrão.Essas são versões de printf, _printf_l, wprintf, _wprintf_l com aprimoramentos de segurança conforme descrito em Recursos de segurança no CRT.
int printf_s( const char *format [, argument]... ); int _printf_s_l( const char *format, locale_t locale [, argument]... ); int wprintf_s( const wchar_t *format [, argument]... ); int _wprintf_s_l( const wchar_t *format, locale_t locale [, argument]... );
Parâmetros
format
Controle de formato.argument
Argumentos opcionais.locale
A localidade a ser usada.
Valor de retorno
Retorna o número de caracteres impressos, ou um valor negativo se ocorrer um erro.
Comentários
A função de printf_s formata e imprime uma série de caracteres e de valores para o fluxo de saída padrão, stdout.Se os argumentos após a cadeia de caracteres de formato , a cadeia de caracteres de format deve conter as especificações que determinam o formato de saída para os argumentos.
A principal diferença entre printf_s e printf é que printf_s verifica a cadeia de caracteres de formato de caracteres de formatação válidos, enquanto printf verifica somente se a cadeia de caracteres de formato é um ponteiro nulo.Se qualquer verificação falhar, um manipulador de parâmetro inválido é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna -1 e defina errno a EINVAL.
Para obter informações sobre errno e os códigos de erro, consulte _doserrno, errno, _sys_errlist, e _sys_nerr.
printf_sefprintf_s se comportam de forma idêntica exceto que grava a saída de printf_s da stdout em vez da um destino do tipo FILE.Para obter mais informações, consulte fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.
wprintf_s é uma versão de largo- caractere de printf_s; format é uma cadeia de caracteres de largo- caractere.wprintf_s e printf_s se comportam de forma idêntica se o fluxo é aberta no modo ANSI.printf_s não tem suporte para a saída em um fluxo de UNICODE.
As versões dessas funções com o sufixo de _l são idênticas exceto que usam o parâmetro de localidade passado em vez de localidade atual da thread.
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _MBCS não definidos |
_MBCS definido |
_unicode definido |
---|---|---|---|
_tprintf_s |
printf_s |
printf_s |
wprintf_s |
_tprintf_s_l |
_printf_s_l |
_printf_s_l |
_wprintf_s_l |
O argumento de format consiste de caracteres, em sequências de escape (e, se os argumentos seguem format) nas especificações comuns de formato.Os caracteres e as sequências de escape comuns são copiados para stdout por ordem de sua aparência.Por exemplo, a linha
printf_s("Line one\n\t\tLine two\n");
produz saída
Line one
Line two
Especificações de formato começa com um sinal de porcentagem (%) e é ler sempre esquerda para a direita.Quando printf_s localizar a primeira especificação de formato (se houver), converte o valor do primeiro argumento após format e saída ele adequadamente.A segunda especificação de formato faz com que o segundo argumento a ser convertido e saída, e assim por diante.Se houver mais argumentos do que há especificações de formato, os argumentos adicionais são ignorados.Os resultados são indefinidos se não houver argumentos suficiente para todas as especificações de formato.
Observação de segurança |
---|
Certifique-se de que format não é uma cadeia de caracteres definida pelo usuário. |
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
printf_s, _printf_s_l |
<stdio.h> |
wprintf_s, _wprintf_s_l |
<stdio.h> ou <wchar.h> |
O console não é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.
Exemplo
// crt_printf_s.c
/* This program uses the printf_s and wprintf_s functions
* to produce formatted output.
*/
#include <stdio.h>
int main( void )
{
char ch = 'h', *string = "computer";
int count = -9234;
double fp = 251.7366;
wchar_t wch = L'w', *wstring = L"Unicode";
/* Display integers. */
printf_s( "Integer formats:\n"
" Decimal: %d Justified: %.6d Unsigned: %u\n",
count, count, count );
printf_s( "Decimal %d as:\n Hex: %Xh C hex: 0x%x Octal: %o\n",
count, count, count, count );
/* Display in different radixes. */
printf_s( "Digits 10 equal:\n Hex: %i Octal: %i Decimal: %i\n",
0x10, 010, 10 );
/* Display characters. */
printf_s("Characters in field (1):\n%10c%5hc%5C%5lc\n", ch, ch, wch, wch);
wprintf_s(L"Characters in field (2):\n%10C%5hc%5c%5lc\n", ch, ch, wch, wch);
/* Display strings. */
printf_s("Strings in field (1):\n%25s\n%25.4hs\n %S%25.3ls\n",
string, string, wstring, wstring);
wprintf_s(L"Strings in field (2):\n%25S\n%25.4hs\n %s%25.3ls\n",
string, string, wstring, wstring);
/* Display real numbers. */
printf_s( "Real numbers:\n %f %.2f %e %E\n", fp, fp, fp, fp );
/* Display pointer. */
printf_s( "\nAddress as: %p\n", &count);
}
A saída de exemplo
Integer formats:
Decimal: -9234 Justified: -009234 Unsigned: 4294958062
Decimal -9234 as:
Hex: FFFFDBEEh C hex: 0xffffdbee Octal: 37777755756
Digits 10 equal:
Hex: 16 Octal: 8 Decimal: 10
Characters in field (1):
h h w w
Characters in field (2):
h h w w
Strings in field (1):
computer
comp
Unicode Uni
Strings in field (2):
computer
comp
Unicode Uni
Real numbers:
251.736600 251.74 2.517366e+002 2.517366E+002
Address as: 0012FF78
Equivalência do .NET Framework
Consulte também
Referência
fprintf, _fprintf_l, fwprintf, _fwprintf_l
scanf, _scanf_l, wscanf, _wscanf_l