Scroll to navigation

TELLDIR(3) Manual del Programador de Linux TELLDIR(3)

NOMBRE

telldir - devuelve la posición actual en un flujo directorio

SINOPSIS

#include <dirent.h>
long telldir(DIR *dirp);

Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

telldir():
_XOPEN_SOURCE
|| /* Glibc since 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPCIÓN

La función telldir() devuelve la posición actual asociada al flujo de directorio dirp.

VALOR DEVUELTO

On success, the telldir() function returns the current location in the directory stream. On error, -1 is returned, and errno is set appropriately.

ERRORES

Descriptor de flujo de directorio inválido dirp.

ATRIBUTOS

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

Interfaz Atributo Valor
telldir() Seguridad del hilo Multi-hilo seguro

CONFORME A

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

NOTAS

In glibc up to version 2.1.1, the return type of telldir() was off_t. POSIX.1-2001 specifies long, and this is the type used since glibc 2.1.2.

In early filesystems, the value returned by telldir() was a simple file offset within a directory. Modern filesystems use tree or hash structures, rather than flat tables, to represent directories. On such filesystems, the value returned by telldir() (and used internally by readdir(3)) is a "cookie" that is used by the implementation to derive a position within a directory. Application programs should treat this strictly as an opaque value, making no assumptions about its contents.

VÉASE TAMBIÉN

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

COLOFÓN

Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.

15 Septiembre 2017