_chdir _wchdir

發行項
03/26/2013

變更目前的工作目錄。

重要

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

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

參數

傳回值

這些函式的傳回值為 0，如果成功。傳回值為 1 表示失敗。如果找不到指定的路徑， errno設定為 ENOENT。如果 dirname 是空的，不正確的參數叫用處理常式，如參數驗證中所述。如果執行允許繼續， errno設定為 EINVAL函式會傳回 -1。

備註

對目錄的工作目錄是由 dirname指定的 _chdir函式變更。 dirname 參數必須參考現有目錄。這個函式可能會在所有磁碟機上的目前工作目錄。如果新的磁碟機代號在 dirname指定，變更預設磁碟機代號。例如，如果是，預設磁碟機代號，而且\ 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>

如需更多關於相容性的資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

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