_mktemp, _wmktemp

Статья
02/20/2013

Создает уникальное имя файла.Существуют более безопасные версии этих функций; см. раздел _mktemp_s, _wmktemp_s.

char *_mktemp(
   char *template 
);
wchar_t *_wmktemp(
   wchar_t *template 
);
template <size_t size>
char *_mktemp(
   char (&template)[size]
); // C++ only
template <size_t size>
wchar_t *_wmktemp(
   wchar_t (&template)[size]
); // C++ only

Параметры

template
Шаблон имени файла.

Возвращаемое значение

Каждая из этих функций возвращает указатель на измененный шаблон.Функция возвращает NULL, если template неправильно сформирован или больше нельзя создать уникальные имена из заданного шаблона.

Заметки

Функция _mktemp создает уникальное имя файла, изменив аргумент template._mktemp автоматически обрабатывает аргументы многобайтовые строки аргументов как подходящие, распознавая многобайтовые последовательности символов в соответствии с многобайтовой кодовой странице в настоящий момент используется системой среды выполнения._wmktemp — это двухбайтовая версия функции _mktemp; аргумент и возвращаемое значение _wmktemp являются строками двухбайтовых символов.В остальных случаях поведение _wmktemp и _mktemp идентично, за исключением того, что _wmktemp не обрабатывает многобайтовые строки.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	Не указаны _UNICODE и _MBCS	_MBCS определен	_UNICODE определен
_tmktemp	_mktemp	_mktemp	_wmktemp

Аргумент template имеет форму baseXXXXXX, где base это часть нового имени файла, и каждый X прототип для символа указанного в _mktemp.Каждый символ заполнителя в template должен быть прописным X._mktemp сохраняет base и заменяет первый замыкающий X на символ алфавита._mktemp заменяет следующие конечные X пятизначным значением; это значение — уникальное число, определяющее вызывающий процесс или, в многопоточных программах, вызывающий поток.

Каждый успешный вызов _mktemp изменяет template.В каждом последующем вызове из одного и того же процесса или потока с тем же аргументом template, проверка _mktemp имен файлов, которые сооветствуют, возвращаемых в предыдущих вызовах _mktemp.Если не существует файла с данным именем, _mktemp возвращает это имя.Если файлы существуют для всех ранее возвращенных имен, _mktemp создает новое имя, заменив алфавитный символ, используемый ранее, следующей доступной буквой нижнего регистра, в порядке от "a" до "z".Например, если: base это:

fn

и пятизначное значение, возвращенное _mktemp — 12345, первое возвращенное имя:

fna12345

Если это имя используется для создания файла FNA12345 и этот файл все еще существует, то следующее имя, возвращенное при вызове из этого же процесса или потока с тем же base для template:

fnb12345

Если FNA12345 не существует, следующее возвращенное имя снова будет:

fna12345

_mktemp может создать максимум 26 уникальных имен файлов для всех заданных сочетаний значений base и template.Поэтому FNZ12345 последнее уникальное имя файла, которое _mktemp может создать для значений base и template, используемых в данном примере.

В случае сбоя, устанавливается errno.Если template имеет недопустимый формат (например, менее 6 X), то errno установлено в EINVAL.Если _mktemp не удалось создать уникальное имя, поскольку все 26 возможных имен файла уже существуют, _mktemp задает шаблон равным пустой строке и возвращает EEXIST.

В C++, эти функции имеют перегруженные шаблонные версии, которые вызывают более новые и безопасные аналоги этих функций.Дополнительные сведения см. в разделе Предоставляйте перегруженный шаблона.

Требования

Функция	Требуемый заголовок
_mktemp	<io.h>
_wmktemp	<io.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

// crt_mktemp.c
// compile with: /W3
/* The program uses _mktemp to create
 * unique filenames. It opens each filename
 * to ensure that the next name is unique.
 */

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

char *template = "fnXXXXXX";
char *result;
char names[27][9];

int main( void )
{
   int i;
   FILE *fp;

   for( i = 0; i < 27; i++ )
   {
      strcpy_s( names[i], sizeof( names[i] ), template );
      /* Attempt to find a unique filename: */
      result = _mktemp( names[i] );  // C4996
      // Note: _mktemp is deprecated; consider using _mktemp_s instead
      if( result == NULL )
      {
         printf( "Problem creating the template\n" );
         if (errno == EINVAL)
         {
             printf( "Bad parameter\n");
         }
         else if (errno == EEXIST)
         {
             printf( "Out of unique filenames\n"); 
         }
      }
      else
      {
         fopen_s( &fp, result, "w" );
         if( fp != NULL )
            printf( "Unique filename is %s\n", result );
         else
            printf( "Cannot open %s\n", result );
         fclose( fp );
      }
   }
}