_chdir、_wchdir

發行項
06/09/2015

變更目前的工作目錄。

重要

這個應用程式開發介面不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

int _chdir( 
   const char *dirname 
);
int _wchdir( 
   const wchar_t *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 and _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");
}