_chdir, _wchdir

Artículo
04/10/2013

Cambie el directorio de trabajo actual.

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

int _chdir( 
   const char *dirname 
);
int _wchdir( 
   const wchar_t *dirname 
);

Parámetros

dirname
Ruta de acceso del nuevo directorio de trabajo.

Valor devuelto

Estas funciones devuelven un valor de 0 si correctamente.Un valor devuelto de – 1 indica el error.Si la ruta de acceso especificada no se encuentra, errno se establece en ENOENT.Si dirname es NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve -1.

Comentarios

Los cambios de función de _chdir que el directorio de trabajo actual en el directorio especificado por dirname.El parámetro de dirname debe hacer referencia a un directorio existente.Esta función puede modificar el directorio de trabajo actual en cualquier unidad.Si una nueva letra de unidad se especifica en dirname, la letra de unidad predeterminada se cambia también.Por ejemplo, si A es la letra de unidad predeterminada y \bin \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C directory, \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C \BIN is the current working directory, the following call changes the current working directory for drive C and establishes C como la nueva unidad predeterminada:

_chdir("c:\\temp");

Cuando se utiliza el carácter de barra diagonal inversa opcional (\) en rutas, debe colocar dos barras diagonales inversas (\\) en literal de cadena de C/C++. para representar una barra diagonal inversa (\).

_wchdir es una versión con caracteres anchos de _chdir; el argumento de dirname a _wchdir es una cadena de caracteres . _wchdir y _chdir se comporta de forma idéntica de otra manera.

Asignación rutinaria de Genérico- texto:

Rutina de Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tchdir	_chdir	_chdir	_wchdir

Requisitos

Rutina	Encabezado necesario	Encabezado opcional
_chdir	<direct.h>	<errno.h>
_wchdir	<direct.h> o <wchar.h>	<errno.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// crt_chdir.c
// arguments: C:\WINDOWS

/* This program uses the _chdir function to verify
   that a given directory exists. */

#include <direct.h>
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>

int main( int argc, char *argv[] )
{

   if(_chdir( argv[1] ) )
   {
      switch (errno)
      {
      case ENOENT:
         printf( "Unable to locate the directory: %s\n", argv[1] );
         break;
      case EINVAL:
         printf( "Invalid buffer.\n");
         break;
      default:
         printf( "Unknown error.\n");
      }
   }
   else
      system( "dir *.exe");
}