.\" -*- coding: UTF-8 -*- .\" Copyright (c) Bruno Haible .\" .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" %%%LICENSE_END .\" .\" References consulted: .\" GNU glibc-2 source code and manual .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH WPRINTF 3 "6 março 2019" GNU "Manual do Programador do Linux" .SH NOME wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- conversão de saída formatada de caracteres largos .SH SINOPSE .nf \fB#include \fP \fB#include \fP .PP \fBint wprintf(const wchar_t *\fP\fIformato\fP\fB, ...);\fP \fBint fwprintf(FILE *\fP\fIfluxo\fP\fB, const wchar_t *\fP\fIformato\fP\fB, ...);\fP \fBint swprintf(wchar_t *\fP\fIwcs\fP\fB, size_t \fP\fImaxcomp\fP\fB,\fP \fB const wchar_t *\fP\fIformato\fP\fB, ...);\fP .PP \fBint vwprintf(const wchar_t *\fP\fIformato\fP\fB, va_list \fP\fIargs\fP\fB);\fP \fBint vfwprintf(FILE *\fP\fIfluxo\fP\fB, const wchar_t *\fP\fIformato\fP\fB, va_list \fP\fIargs\fP\fB);\fP \fBint vswprintf(wchar_t *\fP\fIwcs\fP\fB, size_t \fP\fImaxcomp\fP\fB,\fP \fB const wchar_t *\fP\fIformato\fP\fB, va_list \fP\fIargs\fP\fB);\fP .fi .PP .RS -4 Requisitos de macro de teste de recursos para o glibc (consulte \fBfeature_test_macros\fP(7)): .RE .PP .ad l Todas as funções mostradas acima: .RS 4 .\" .BR wprintf (), .\" .BR fwprintf (), .\" .BR swprintf (), .\" .BR vwprintf (), .\" .BR vfwprintf (), .\" .BR vswprintf (): _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE || .br _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIÇÃO A família de funções \fBwprintf\fP() é a equivalente para caracteres largos à família de funções \fBprintf\fP(3). Ela realiza a saída formatada de caracteres largos. .PP As funções \fBwprintf\fP() e \fBvwprintf\fP() realizam saída de caracteres largos para \fIstdout\fP. \fIstdout\fP não deve ser orientado a byte; veja \fBfwide\fP(3) para maiores informações. .PP As funções \fBfwprintf\fP() e \fBvfwprintf\fP() realizam saída de caracteres largos para \fIfluxo\fP. \fIfluxo\fP não deve ser orientado a byte; veja \fBfwide\fP(3) para maiores informações. .PP As funções \fBswprintf\fP() e \fBvswprintf\fP() realizam saída de caracteres largos para um array de caracteres largos. O programador deve garantir que há espaço suficiente para no mínimo \fImaxlen\fP caracteres largos em \fIwcs\fP. .PP Estas funções são como as funções \fBprintf\fP(3), \fBvprintf\fP(3), \fBfprintf\fP(3), \fBvfprintf\fP(3), \fBsprintf\fP(3), \fBvsprintf\fP(3) exceto pelas seguintes diferenças: .TP \fB\(bu\fP A \fIformato\fP é uma string de caracteres largos. .TP \fB\(bu\fP A saída consiste de caracteres largos, não bytes. .TP \fB\(bu\fP \fBswprintf\fP() e \fBvswprintf\fP() recebem um argumento \fImaxcomp\fP, \fBsprintf\fP(3) e \fBvsprintf\fP(3) não recebem. (\fBsnprintf\fP(3) e \fBvsnprintf\fP(3) recebem um argumento \fImaxcomp\fP, mas estas funções não retornam \-1 quando ocorre um estouro de buffer no GNU/Linux.) .PP O tratamento de caracteres de conversão \fBc\fP e \fBs\fP é diferente: .TP \fBc\fP Se nenhum modificador \fBl\fP está presente, o argumento \fIint\fP é convertido para um caractere largo por uma chamada a para a função \fBbtowc\fP(3), e o caractere largo resultante é escrito. Se um modificador \fBl\fP está presente, o argumento \fIwint_t\fP (caractere largo) é escrito. .TP \fBs\fP Se nenhum modificador \fBl\fP está presente: O argumento \fIconst\ char\ *\fP é esperado como um ponteiro para um tipo de array de caracteres (ponteiro para uma string) contendo uma sequência de caracteres multibyte começando no estado de transição inicial. Caracteres do array são convertidos para caracteres largos (cada um por uma chamada à função \fBmbrtowc\fP(3) com um estado de conversão iniciando no estado inicial antes do primeiro byte). Os caracteres largos resultantes são escritos até (mas não incluindo) o caractere largo nulo de terminação (L\(aq\e0\(aq). Se uma precisão é especificado, nenhum caractere largo a mais que o número especificado é escrito. Note que a precisão determina o número de \fIcaracteres largos\fP escritos, não o número de \fIbytes\fP ou \fIposições de tela\fP. O array deve conter um byte nulo de terminação (\(aq\e0\(aq), a não ser que a precisão seja dada e ela seja tão pequena que o número de caracteres largos convertidos a alcance antes que o fim do array seja alcançado. \-\- Se um modificador \fBl\fP está presente: O argumento \fIconst\ wchar_t\ *\fP é esperado como um ponteiro para um array de caracteres largos. Caracteres largos do array são escritos até (mas não incluindo) um caractere largo nulo de terminação. Se uma precisão é especificada, nenhum caractere largo a mais do que o número especifica é escrito. O array deve conter um caractere largo nulo de terminação, a não ser que a precisão seja dada e ela seja menor ou igual ao número de caracteres largos no array. .SH "VALOR DE RETORNO" As funções retornam o número de caracteres largos escritos, excluindo\-se o caractere largo nulo de terminação no caso das funções \fBswprintf\fP() e \fBvswprintf\fP(). Elas retornam \-1 quando ocorre um erro. .SH ATRIBUTOS Para uma explicação dos termos usados nesta seção, consulte \fBattributes\fP(7). .TS allbox; lbw24 lb lb l l l. Interface Atributo Valor T{ \fBwprintf\fP(), \fBfwprintf\fP(), .br \fBswprintf\fP(), \fBvwprintf\fP(), .br \fBvfwprintf\fP(), \fBvswprintf\fP() T} Thread safety MT\-Safe locale .TE .sp 1 .SH "DE ACORDO COM" POSIX.1\-2001, POSIX.1\-2008, C99. .SH NOTAS O comportamento de \fBwprintf\fP() etc. depende da categoria \fBLC_CTYPE\fP da localização atual. .PP Se a string \fIformato\fP contiver caracteres largos não\-ASCII, o programa funcionará corretamente apenas se a categoria \fBLC_CTYPE\fP da localização atual em tempo de execução for a mesma que a categoria \fBLC_CTYPE\fP da localização atual em tempo de compilação. Isto é porque a representação \fIwchar_t\fP é dependente de plataforma e da localização. (A glibc representa caracteres largos usando seu ponto de código Unicode (ISO\-10646), mas outras plataformas não o fazem. Ademais, o uso de nomes de caracteres universais C99 da forma \eunnnn não resolve este problema.) Portanto, em programas internacionalizados, a string \fIformato\fP deve consistir apenas de caracteres largos ASCII, ou deve ser compilado em tempo de execução de forma internacionalizada (ou seja, usando \fBgettext\fP(3) ou \fBiconv\fP(3), seguido de \fBmbstowcs\fP(3)). .SH "VEJA TAMBÉM" .\" .BR wscanf (3) \fBfprintf\fP(3), \fBfputwc\fP(3), \fBfwide\fP(3), \fBprintf\fP(3), \fBsnprintf\fP(3) .SH COLOFÃO Esta página faz parte da versão 5.10 do projeto Linux \fIman\-pages\fP. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em \%https://www.kernel.org/doc/man\-pages/. .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Felipe M Pereira , Ricardo C.O.Freitas e Rafael Fontenelle . . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .