fgetws(3) Library Functions Manual fgetws(3) NOME fgetws - le uma sequencia de caracteres largos a partir de um fluxo de arquivo BIBLIOTECA Standard C library (libc, -lc) SINOPSE #include wchar_t *fgetws(wchar_t ws[restrict .n], int n, ARQUIVO *restrict stream); DESCRICAO A funcao fgetws() e a equivalente para caracteres largos da funcao fgets(3). Ela le uma sequencia de, no maximo, n-1 caracteres largos e coloca na matriz de caracteres largos apontada por ws, e adiciona um caractere de terminacao nulo (L'\0'). Ela para de ler caracteres largos depois que encontra e armazena um caractere largo de nova linha. Ela tambem para quando o fim do fluxo e atingido. O programador precisa assegurar-se de que ha espaco para pelo menos n caracteres largos em ws. Para uma contraparte nao-bloqueante, veja unlocked_stdio(3). VALOR DE RETORNO A funcao fgetws(), se bem-sucedida, retorna ws. Se o fim do fluxo ja foi encontrado, ou se ocorreu um erro, ela retorna NULL. ATRIBUTOS Para uma explicacao dos termos usados nesta secao, consulte attributes(7). +--------------------------------------------+---------------+---------+ |Interface | Atributo | Valor | +--------------------------------------------+---------------+---------+ |fgetws() | Thread safety | MT-Safe | +--------------------------------------------+---------------+---------+ PADROES C11, POSIX.1-2008. HISTORICO POSIX.1-2001, C99. NOTAS O comportamento de fgetws() depende da categoria LC_CTYPE da localizacao atual. Na ausencia de informacoes adicionais passadas para a chamada fopen(3), e razoavel esperar que fgetws() ira ler, no momento, uma sequencia multibyte a partir do fluxo e entao converte-la para uma sequencia de caracteres largos. Esta funcao nao e confiavel, porque ela nao permite lidar adequadamente com caracteres largos nulos que possam estar presentes na entrada. VEJA TAMBEM fgetwc(3), unlocked_stdio(3) TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Rubens de Jesus Nogueira , Andre Luiz Fassone e Rafael Fontenelle . Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . Linux man-pages 6.12 23 julho 2024 fgetws(3)