telldir(3)

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