Compartilhar via


_chdir, _wchdir

Altera o diretório de trabalho corrente.

Observação importanteImportante

Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

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

Parâmetros

  • dirname
    Caminho da nova pasta de trabalho.

Valor de retorno

Essas funções retornam um valor de 0 se com êxito.Um valor de retorno de 1 – indica a falha.Se o caminho especificado não pôde ser encontrado, errnoé definido como ENOENT.Se dirname é NULO, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, errnoé definido como EINVALe para a função retorna -1.

Comentários

As alterações de função de _chdiro diretório de trabalho corrente para o diretório especificado por dirname.O parâmetro de dirname deve se referir a um diretório existente.Essa função pode alterar o diretório de trabalho corrente em qualquer unidade.Se uma nova letra da unidade for especificada em dirname, a letra da unidade padrão é alterada também.Por exemplo, se Um é a letra da unidade padrão e \ COMPARTIMENTO é o diretório de trabalho corrente, as seguintes alterações de chamada o diretório de trabalho corrente para a unidade C e estabelecem C como a nova unidade padrão:

_chdir("c:\\temp");

Quando você usa o caractere de barra invertida (opcional) nos caminhos\, você deve colocar duas barras invertidas\\() na cadeia de caracteres literal de energia AC para representar uma barra invertida (\).

_wchdiré uma versão de largo- caractere de _chdir; o argumento de dirname a _wchdiré uma cadeia de caracteres. _wchdirde largo- caractere e _chdirse comporta de forma idêntica.

Mapeamento rotineiro de Genérico- texto:

Rotina de Tchar.h

_UNICODE e não definidos _MBCS

_MBCS definido

_UNICODE definido

_tchdir

_chdir

_chdir

_wchdir

Requisitos

Rotina

Cabeçalho necessário

Cabeçalho opcional

_chdir

<direct.h>

<errno.h>

_wchdir

<direct.h> ou <wchar.h>

<errno.h>

Para mais informações, consulte Compatibilidade de compatibilidade na introdução.

Exemplo

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

Equivalência do .NET Framework

System::Environment::CurrentDirectory

Consulte também

Referência

Controle de diretório

_mkdir, _wmkdir

_rmdir, _wrmdir

sistema, _wsystem