subrutina getwd
Finalidad
Obtiene el nombre de vía de acceso del directorio actual.
Biblioteca
Biblioteca C estándar (libc.a)
Sintaxis
Descripción
La subrutina getwd determina el nombre de vía de acceso absoluta del directorio actual y, a continuación, copia dicho nombre de vía de acceso en el área a la que apunta el parámetro PathName .
La longitud máxima del nombre de vía de acceso, en caracteres, se establece mediante el valor PATH_MAX , tal como se especifica en el archivo limits.h .
Parámetros
| Elemento | Descripción |
|---|---|
| PathName | Apunta al nombre completo de la vía de acceso. |
Valores de retorno
Si la llamada a la subrutina getwd es satisfactoria, se devuelve un puntero al nombre de vía de acceso absoluta del directorio actual. Si se produce un error, la subrutina getwd devuelve un valor nulo y coloca un mensaje de error en el parámetro PathName .
En la modalidad UNIX03 , la subrutina getwd devuelve un valor nulo si el nombre de vía de acceso real es más largo que el valor definido por PATH_MAX. En la modalidad anterior, la subrutina getwd devuelve un nombre de vía de acceso truncado si el nombre de vía de acceso es más largo que PATH_MAX. El comportamiento anterior se puede inhabilitar estableciendo la variable de entorno XPG_SUS_ENV = ON.