_mkdir, _wmkdir
Crea un nuevo directorio.
int _mkdir(
const char *dirname
);
int _wmkdir(
const wchar_t *dirname
);
Parámetros
- dirname
Ruta de acceso para un nuevo directorio.
Valor devuelto
Cada una de estas funciones devuelve el valor 0 si el nuevo directorio se creó.En un error, la función devuelve – 1 y establece errno como sigue.
EEXIST
El directorio no se creó porque dirname es el nombre de un archivo existente, un directorio, o de un dispositivo.ENOENT
La ruta no se encontró.
Para obtener más información sobre éstos y otros códigos de retorno, vea _doserrno, errno, _sys_errlist, y _sys_nerr.
Comentarios
la función de _mkdir crea un nuevo directorio con el dirnameespecificado . _mkdir sólo puede crear un nuevo directorio por llamada, tan sólo el componente último de dirname puede llamar a un nuevo directorio._mkdir no traduce los delimitadores de la ruta.En windows NT, la barra diagonal inversa (\) y la barra diagonal (/) son delimitadores de ruta válidos en cadenas de caracteres en rutinas de servicio.
_wmkdir es una versión con caracteres anchos de _mkdir; el argumento de dirname a _wmkdir es una cadena de caracteres._wmkdir y _mkdir se comportan exactamente igual de otra manera.
Asignaciones de la rutina de texto genérico
rutina de Tchar.h |
_UNICODE y _MBCS no definido |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_tmkdir |
_mkdir |
_mkdir |
_wmkdir |
Requisitos
rutina |
Encabezado necesario |
---|---|
_mkdir |
<direct.h> |
_wmkdir |
<direct.h> o <wchar.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.
bibliotecas
todas las versiones de Bibliotecas en tiempo de ejecución de C.
Ejemplo
// crt_makedir.c
#include <direct.h>
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
if( _mkdir( "\\testtmp" ) == 0 )
{
printf( "Directory '\\testtmp' was successfully created\n" );
system( "dir \\testtmp" );
if( _rmdir( "\\testtmp" ) == 0 )
printf( "Directory '\\testtmp' was successfully removed\n" );
else
printf( "Problem removing directory '\\testtmp'\n" );
}
else
printf( "Problem creating directory '\\testtmp'\n" );
}
Resultados del ejemplo
Directory '\testtmp' was successfully created
Volume in drive C has no label.
Volume Serial Number is E078-087A
Directory of C:\testtmp
02/12/2002 09:56a <DIR> .
02/12/2002 09:56a <DIR> ..
0 File(s) 0 bytes
2 Dir(s) 15,498,690,560 bytes free
Directory '\testtmp' was successfully removed