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);

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).

PADRÕES

POSIX.1-2008.

HISTÓRICO

POSIX.1-2001, 4.3BSD.

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 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.