telldir(3)                 Library Functions Manual                 telldir(3)

NOME
       telldir - retorna a localizacao atual no fluxo de diretorio

BIBLIOTECA
       Biblioteca C Padrao (libc, -lc)

SINOPSE
       #include <dirent.h>

       long telldir(DIR *dirp);

   Requisitos de macro de teste de recursos para o glibc (consulte
   feature_test_macros(7)):

       telldir():
           _XOPEN_SOURCE
              || /* glibc >= 2.19: */ _DEFAULT_SOURCE
              || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRICAO
       A funcao telldir() retorna a localizacao atual associada com o fluxo de
       diretorio dirp.

VALOR DE RETORNO
       No caso de sucesso, a funcao telldir() retorna a localizacao atual no
       fluxo de diretorio. No caso de erro, -1 e retornado e errno e definido
       para indicar o erro.

ERROS
       EBADF  Descritor de fluxo de diretorio dirp invalido.

ATRIBUTOS
       Para uma explicacao dos termos usados nesta secao, consulte
       attributes(7).

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Atributo      | Valor   |
       +--------------------------------------------+---------------+---------+
       |telldir()                                   | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+
PADROES
       POSIX.1-2008.

HISTORICO
       POSIX.1-2001, 4.3BSD.

       Ate o glibc 2.1.1, o tipo de retorno de telldir() era off_t.
       POSIX.1-2001 especifica long, e este e o tipo usado desde o glibc
       2.1.2.

       Nos primeiros sistemas de arquivos, o valor retornado por telldir() era
       um simples deslocamento de arquivo dentro de um diretorio. Os sistemas
       de arquivos modernos usam estruturas de arvore ou hash, em vez de
       tabelas simples, para representar diretorios. Nesses sistemas de
       arquivos, o valor retornado por telldir() (e usado internamente por
       readdir(3)) e um "cookie" usado pela implementacao para derivar uma
       posicao dentro de um diretorio. Os programas aplicativos devem tratar
       isso estritamente como um valor opaco, fazendo suposicoes sobre seu
       conteudo.

VEJA TAMBEM
       closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3),
       seekdir(3)

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Daniel Chicayban <daniel@chicayban.com.br>, Ricardo C.O.Freitas
       <english.quest@best-service.com> e Rafael Fontenelle
       <rafaelff@gnome.org>.

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> 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
       <debian-l10n-portuguese@lists.debian.org>.

Linux man-pages 6.06            31 outubro 2023                     telldir(3)