_chdir, _wchdir

아티클
06/09/2015

현재 작업 디렉터리를 변경합니다.

중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.

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

매개 변수

dirname
새 작업 디렉터리의 경로입니다.

반환 값

이러한 함수는 성공하면 0의 값을 반환합니다. 반환 값 -1은 실패를 나타냅니다. 지정된 경로를 찾을 수 없는 경우, errno 는 ENOENT 로 설정합니다. 여기 dirname 이 NULL인 경우, 매개 변수 유효성 검사 인 경우에 설명된 대로 잘못된 매개 변수가 호출됩니다. 계속 실행하려는 경우, errno 는 EINVAL 으로 설정하고 함수는 -1을 반환합니다.

설명

이 _chdir 함수는 현재 작업 디렉터리에 dirname로 지정된 디렉토리로 변경합니다. 이 dirname 매개 변수가 기존 디렉터리를 참조해야 합니다. 이 함수는 모든 드라이브의 현재 작업 디렉터리를 변경할 수 있습니다. 새 드라이브 문자에 dirname로 지정 된 경우, 기본 드라이브 문자를 변경합니다. 예로, A가 기본 드라이브 문자이고 \BIN가 현재 작업 디렉터리의 경우, 다음 호출은 C 드라이브와 새로운 기본 드라이버를 C로 현재 작업 디렉터리를 변화합니다:

_chdir("c:\\temp");

경로에서 선택적 백슬래시 문자(\)를 사용하는 경우, 단일 슬래시(\)로 나타나는 C 문자열 리터널의 두개의 백슬래시(\\)를 대체해야 합니다.

_wchdir 은 _chdir의 와이드 문자 버전입니다; _wchdir 하는 dirname 인수는 동일하게 동작하는 와이드 문자열. _wchdir 및 _chdir 입니다.

제네릭 텍스트 라우팅 매핑:

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tchdir	_chdir	_chdir	_wchdir

요구 사항

루틴	필수 헤더	선택적 헤더
_chdir	<direct.h>	<<errno.h>>
_wchdir	<direct.h> 또는 <wchar.h>	<<errno.h>>

호환성 정보에 대한 자세한 내용은 호환성을 참조하십시오.

예제

// 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");
}