다음을 통해 공유

_mktemp_s, _wmktemp_s

  • 아티클

고유한 파일 이름을 만듭니다. 이러한 함수는 _mktemp 버전, CRT 보안 기능에 설명된 것 처럼 보안 기능이 향상된 _wmktemp입니다.

구문

errno_t _mktemp_s(
   char *nameTemplate,
   size_t sizeInChars
);
errno_t _wmktemp_s(
   wchar_t *nameTemplate,
   size_t sizeInChars
);
template <size_t size>
errno_t _mktemp_s(
   char (&nameTemplate)[size]
); // C++ only
template <size_t size>
errno_t _wmktemp_s(
   wchar_t (&nameTemplate)[size]
); // C++ only

매개 변수

nameTemplate
파일 이름 패턴입니다.

sizeInChars
_mktemp_s에 있는 싱글바이트 문자 및 _wmktemp_s에 있는 와이드 문자의 버퍼 크기입니다(null 종결자 포함).

반환 값

이 두 함수는 모두 정상적으로 실행되면 0을 반환하고 실행 시 오류가 발생하면 오류 코드를 반환합니다.

오류 조건

nameTemplate sizeInChars 반환 값 의 새 값 nameTemplate
NULL any EINVAL NULL
형식이 잘못되었습니다(올바른 형식의 경우 설명 섹션 참조) any EINVAL 빈 문자열
any <= X자 수 EINVAL 빈 문자열

위의 오류 조건이 발생하면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용한 경우 errno는 EINVAL로 설정되고 함수는 EINVAL을 반환합니다.

설명

_mktemp_s 함수는 호출 후에 nameTemplate 포인터가 새 파일 이름을 포함하는 문자열을 가리키도록 nameTemplate 인수를 수정하여 고유한 파일 이름을 만듭니다. _mktemp_s는 런타임 시스템에서 최근에 사용 중인 멀티바이트 코드 페이지에 따라 멀티바이트 문자 시퀀스를 인식하면서 자동으로 멀티바이트 문자열 인수를 적절하게 처리합니다. _wmktemp_s는 _mktemp_s의 와이드 문자 버전이며 _wmktemp_s의 인수는 와이드 문자열입니다. _wmktemp_s 멀티 _mktemp_s 바이트 문자열을 처리하지 않는다는 점을 제외하고 _wmktemp_s , 그렇지 않으면 동일하게 동작합니다.

이러한 함수의 디버그 라이브러리 버전은 먼저 버퍼를 0xFE 채웁니다. 이 동작을 사용하지 않도록 설정하려면 .를 사용합니다 _CrtSetDebugFillThreshold.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

Tchar.h 루틴 _UNICODE 및 _MBCS 정의되지 않음 정의된 _MBCS 정의된 _UNICODE
_tmktemp_s _mktemp_s _mktemp_s _wmktemp_s

nameTemplate 인수의 형식은 baseXXXXXX입니다. 여기서 base는 지정하는 새 파일 이름에 속하며 각 X는 _mktemp_s에서 제공하는 문자열에 대한 자리 표시자입니다. nameTemplate의 각 자리 표시자 문자는 대문자 X여야 합니다. _mktemp_s는 base를 유지하고 첫 번째 후행 X를 영문자로 바꿉니다. _mktemp_s 는 다음 X 문자를 5자리 값으로 바꿉니다. 이 값은 호출 프로세스 또는 다중 스레드 프로그램에서 호출 스레드를 식별하는 고유 번호입니다.

_mktemp_s에 대한 호출에 성공할 때마다 nameTemplate이 수정됩니다. 동일한 nameTemplate 인수를 사용하는 동일한 프로세스 또는 스레드로부터의 각 후속 호출에서 _mktemp_s는 이전 호출에서 _mktemp_s가 반환한 이름과 일치하는 파일 이름을 검사합니다. 지정된 이름에 대한 파일이 없는 경우 _mktemp_s는 해당 이름을 반환합니다. 이전에 반환된 이름에 대한 파일이 존재하는 경우 _mktemp_s는 이전에 반환된 이름에서 사용한 영문자를 다음에 사용할 수 있는 소문자('a'에서 'z'로의 순서)로 대체하여 새 이름을 만듭니다. 예를 들어 base가 다음과 같고

fn

_mktemp_s에서 제공하는 5자리 숫자 값이 12345인 경우 첫 번째 반환된 이름은 다음과 같습니다.

fna12345

이 이름이 FNA12345 파일을 만드는 데 사용되고 이 파일이 계속 존재하는 경우 base에 대해 동일한 nameTemplate를 사용하여 동일한 프로세스 또는 스레드로부터의 호출에서 반환된 다음 이름은 아래와 같습니다.

fnb12345

FNA12345 없는 경우 반환된 다음 이름은 다시 다음과 같습니다.

fna12345

_mktemp_s 는 지정된 값 조합 base 에 nameTemplate 대해 최대 26개 고유 파일 이름을 만들 수 있습니다. 따라서 FNZ12345는 _mktemp_s가 이 예제에서 사용된 base 및 nameTemplate 값에 대해 만들 수 있는 마지막 고유한 파일 이름입니다.

C++에서는 템플릿 오버로드로 인해 이러한 함수를 사용하는 것이 보다 간단해 집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으며(크기 인수를 지정할 필요가 없어짐), 기존의 비보안 함수를 보다 최신의 보안 대응 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드를 참조하세요.

요구 사항

루틴에서 반환된 값 필수 헤더
_mktemp_s <io.h>
_wmktemp_s <io.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_mktemp_s.cpp
/* The program uses _mktemp to create
* five unique filenames. It opens each filename
* to ensure that the next name is unique.
*/

#include <io.h>
#include <string.h>
#include <stdio.h>

char *fnTemplate = "fnXXXXXX";
char names[5][9];

int main()
{
   int i, err, sizeInChars;
   FILE *fp;

   for( i = 0; i < 5; i++ )
   {
      strcpy_s( names[i], sizeof(names[i]), fnTemplate );
      /* Get the size of the string and add one for the null terminator.*/
      sizeInChars = strnlen(names[i], 9) + 1;
      /* Attempt to find a unique filename: */
      err = _mktemp_s( names[i], sizeInChars );
      if( err != 0 )
         printf( "Problem creating the template" );
      else
      {
         if( fopen_s( &fp, names[i], "w" ) == 0 )
            printf( "Unique filename is %s\n", names[i] );
         else
            printf( "Cannot open %s\n", names[i] );
         fclose( fp );
      }
   }

   return 0;
}

샘플 출력

Unique filename is fna03188
Unique filename is fnb03188
Unique filename is fnc03188
Unique filename is fnd03188
Unique filename is fne03188

참고 항목

파일 처리
fopen, _wfopen
_getmbcp
_getpid
_open, _wopen
_setmbcp
_tempnam, _wtempnam, tmpnam_wtmpnam
tmpfile_s