_makepath
, _wmakepath
구성 요소에서 경로 이름을 만듭니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. _makepath_s
, _wmakepath_s
(을)를 참조하세요.
구문
void _makepath(
char *path,
const char *drive,
const char *dir,
const char *fname,
const char *ext
);
void _wmakepath(
wchar_t *path,
const wchar_t *drive,
const wchar_t *dir,
const wchar_t *fname,
const wchar_t *ext
);
매개 변수
path
전체 경로 버퍼입니다.
drive
원하는 드라이브에 따른 문자(A, B 등) 및 후행 콜론(선택 사항)을 포함합니다. _makepath
가 누락된 경우 콜론을 복합 경로에 자동으로 삽입합니다. drive
가 NULL
또는 빈 문자열을 가리키는 경우 복합 path
문자열에 드라이브 문자가 나타나지 않습니다.
dir
드라이브 지정자 또는 실제 파일 이름을 제외한 디렉터리의 경로를 포함합니다. 후행 슬래시는 선택 사항이며 슬래시(/
) 또는 백슬래시(\
) 또는 둘 다 단일 dir
인수에 사용될 수 있습니다. 후행 슬래시(/
또는 \
)를 지정하지 않으면 자동으로 삽입됩니다. dir
이 NULL
이거나 빈 문자열을 가리키는 경우 복합 path
문자열에 디렉터리 경로가 삽입되지 않습니다.
fname
파일 확장명 없이 기본 파일 이름을 포함합니다. fname
이 NULL
이거나 빈 문자열을 가리키는 경우 복합 path
문자열에 파일 이름이 삽입되지 않습니다.
ext
선행 기간(.
)을 포함하거나 포함하지 않는 실제 파일 이름 확장명을 포함합니다. _makepath
에 표시되지 않으면 마침표가 자동으로 삽입됩니다 ext
. ext
가 NULL
이거나 빈 문자열을 가리키는 경우 복합 path
문자열에 확장명이 삽입되지 않습니다.
설명
_makepath
함수는 개별 구성 요소에서 복합 경로 문자열을 만들고 결과를 path
에 저장합니다. path
는 드라이브 문자, 디렉터리 경로, 파일 이름 및 파일 확장명을 포함할 수 있습니다. _wmakepath
는 _makepath
의 와이드 문자 버전이며, _wmakepath
에 대한 인수는 와이드 문자 문자열입니다. 그렇지 않으면_wmakepath
과 _makepath
이 동일하게 작동합니다.
보안 정보 null로 끝나는 문자열을 사용하세요. 버퍼 오버런을 방지하기 위해 null로 끝나는 문자열은 path
버퍼의 크기를 초과할 수 없습니다. _makepath
에서는 복합 경로 문자열의 길이가 초과 _MAX_PATH
되지 않도록 합니다. 자세한 내용은 버퍼 오버런 방지를 참조하세요.
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
일반 텍스트 루틴 매핑
Tchar.h 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
---|---|---|---|
_tmakepath |
_makepath |
_makepath |
_wmakepath |
path
인수는 전체 경로를 포함할 수 있도록 충분히 큰 빈 버퍼를 가리켜야 합니다. 복합 path
는 Stdlib.h에 정의된 _MAX_PATH
상수보다 크지 않아야 합니다.
경로인 NULL
경우 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 또한 errno
는 EINVAL
로 설정됩니다. NULL
값은 다른 모든 매개 변수에 대해 허용됩니다.
요구 사항
루틴에서 반환된 값 | 필수 헤더 |
---|---|
_makepath |
<stdlib.h> |
_wmakepath |
<stdlib.h> 또는 <wchar.h> |
호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// crt_makepath.c
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
char path_buffer[_MAX_PATH];
char drive[_MAX_DRIVE];
char dir[_MAX_DIR];
char fname[_MAX_FNAME];
char ext[_MAX_EXT];
_makepath( path_buffer, "c", "\\sample\\crt\\", "makepath", "c" ); // C4996
// Note: _makepath is deprecated; consider using _makepath_s instead
printf( "Path created with _makepath: %s\n\n", path_buffer );
_splitpath( path_buffer, drive, dir, fname, ext ); // C4996
// Note: _splitpath is deprecated; consider using _splitpath_s instead
printf( "Path extracted with _splitpath:\n" );
printf( " Drive: %s\n", drive );
printf( " Dir: %s\n", dir );
printf( " Filename: %s\n", fname );
printf( " Ext: %s\n", ext );
}
Path created with _makepath: c:\sample\crt\makepath.c
Path extracted with _splitpath:
Drive: c:
Dir: \sample\crt\
Filename: makepath
Ext: .c
참고 항목
파일 처리
_fullpath
, _wfullpath
_splitpath
, _wsplitpath
_makepath_s
, _wmakepath_s