Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_getcwd, _wgetcwd

Obtiene el directorio de trabajo actual.

Nota importante Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas con /ZW.

char *_getcwd( 
   char *buffer,
   int maxlen 
);
wchar_t *_wgetcwd( 
   wchar_t *buffer,
   int maxlen 
);

buffer

Ubicación de almacenamiento de la ruta de acceso.

maxlen

Longitud máxima de la ruta de acceso en caracteres: char para _getcwd y wchar_t para _wgetcwd.

Devuelve un puntero a buffer. Un valor devuelto de NULL indica un error, y errno se establece en ENOMEM, que indica que no hay memoria suficiente para asignar los bytes de maxlen (cuando un argumento de NULL se proporciona como buffer), o en ERANGE, que indica que la ruta de acceso es más larga que los caracteres de maxlen. Si maxlen es menor o igual que cero, esta función invoca un controlador de parámetros no válidos, como se describe en Validación de parámetros.

Para obtener más información sobre estos y otros códigos de retorno, vea _doserrno, errno, _sys_errlist y _sys_nerr.

La función _getcwd obtiene la ruta de acceso completa del directorio de trabajo actual para la unidad predeterminada y la almacena en buffer. El argumento de entero maxlen especifica la longitud máxima de la ruta de acceso. Se produce un error si la longitud de la ruta de acceso (incluido el carácter nulo final) es mayor que maxlen. El argumento de buffer puede ser NULL; se asigna automáticamente un búfer con un tamaño mínimo de maxlen (más solo en caso necesario) mediante malloc, para almacenar la ruta de acceso. Este búfer se puede liberar más adelante llamando a free y pasando el valor devuelto de _getcwd (un puntero al búfer asignado).

_getcwd devuelve una cadena que representa la ruta de acceso del directorio de trabajo actual. Si el directorio de trabajo actual es la raíz, la cadena finaliza con una barra diagonal inversa ( \). Si el directorio de trabajo actual es un directorio distinto de la raíz, la cadena finaliza con el nombre de directorio y no con una barra diagonal inversa.

_wgetcwd es una versión con caracteres anchos de _getcwd; el argumento de buffer y el valor devuelto de _wgetcwd son cadenas de caracteres anchos. Por lo demás, _wgetcwd y _getcwd se comportan de forma idéntica.

Cuando se definen _DEBUG y _CRTDBG_MAP_ALLOC, las llamadas a _getcwd y _wgetcwd se reemplazan por llamadas a _getcwd_dbg y _wgetcwd_dbg para admitir asignaciones de memoria de depuración. Para obtener más información, vea _getcwd_dbg, _wgetcwd_dbg.

Asignaciones de rutina de texto genérico

Rutina Tchar.h

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tgetcwd

_getcwd

_getcwd

_wgetcwd

Rutina

Encabezado necesario

_getcwd

<direct.h>

_wgetcwd

<direct.h> o <wchar.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

// crt_getcwd.c
// This program places the name of the current directory in the 
// buffer array, then displays the name of the current directory 
// on the screen. Passing NULL as the buffer forces getcwd to allocate
// memory for the path, which allows the code to support file paths
// longer than _MAX_PATH, which are supported by NTFS.
 
#include <direct.h>
#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char* buffer;

   // Get the current working directory: 
   if( (buffer = _getcwd( NULL, 0 )) == NULL )
      perror( "_getcwd error" );
   else
   {
      printf( "%s \nLength: %d\n", buffer, strnlen(buffer) );
      free(buffer);
   }
}
C:\Code

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft