NOME

       telldir - retorna a localização atual no fluxo de diretório

BIBLIOTECA

       Biblioteca C Padrão (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

DESCRIÇÃO

       A função telldir() retorna a localização atual associada com o fluxo de diretório dirp.

VALOR DE RETORNO

       No  caso de sucesso, a função telldir() retorna a localização atual no fluxo de diretório.
       No caso de erro, -1 é retornado e errno é definido para indicar o erro.

ERROS

       EBADF  Descritor de fluxo de diretório dirp inválido.

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).

       ┌───────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │Interface                                                      │ Atributo      │ Valor   │
       ├───────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │telldir()                                                      │ Thread safety │ MT-Safe │
       └───────────────────────────────────────────────────────────────┴───────────────┴─────────┘

PADRÕES

       POSIX.1-2001, POSIX.1-2008, 4.3BSD.

NOTAS

       Até o glibc 2.1.1, o tipo de retorno de telldir() era off_t. POSIX.1-2001 especifica long,
       e este é 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 diretório. Os  sistemas  de  arquivos  modernos  usam
       estruturas  de  árvore  ou  hash,  em vez de tabelas simples, para representar diretórios.
       Nesses sistemas de arquivos, o valor retornado por telldir()  (e  usado  internamente  por
       readdir(3))  é  um "cookie" usado pela implementação para derivar uma posição dentro de um
       diretório. Os programas aplicativos devem tratar isso estritamente como  um  valor  opaco,
       fazendo suposições sobre seu conteúdo.

VEJA TAMBÉM

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

TRADUÇÃO

       A  tradução  para  português  brasileiro  desta página 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  tradução  é  uma  documentação  livre;  leia  a  Licença  Pública Geral GNU Versão 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ ou posterior para  as  condições  de  direitos
       autorais.  Nenhuma responsabilidade é aceita.

       Se  você  encontrar  algum erro na tradução desta página de manual, envie um e-mail para a
       lista de discussão de tradutores ⟨debian-l10n-portuguese@lists.debian.org⟩.