_makepath_s, _wmakepath_s

Статья
02/20/2013

Создает имя пути из компонентов.Эти версии _makepath, _wmakepath со службами расширений безопасности, как описано в разделе Средства безопасности в CRT.

errno_t _makepath_s(
   char *path,
   size_t sizeInBytes,
   const char *drive,
   const char *dir,
   const char *fname,
   const char *ext 
);
errno_t _wmakepath_s(
   wchar_t *path,
   size_t sizeInWords,
   const wchar_t *drive,
   const wchar_t *dir,
   const wchar_t *fname,
   const wchar_t *ext 
);
template <size_t size>
errno_t _makepath_s(
   char (&path)[size],
   const char *drive,
   const char *dir,
   const char *fname,
   const char *ext 
); // C++ only
template <size_t size>
errno_t _wmakepath_s(
   wchar_t (&path)[size],
   const wchar_t *drive,
   const wchar_t *dir,
   const wchar_t *fname,
   const wchar_t *ext 
); // C++ only

Параметры

[исходящий] path
Буфер полного пути.
[входящий] sizeInWords
Размер буфера в машинных словам.
[входящий] sizeInBytes
Размер буфера в байтах.
[входящий] drive
Содержит букву (a, B, и т д), соответствующий требуемому диску и необязательному замыкающий двоеточию._makepath_s вставляет двоеточие автоматически в составной путь, если он отсутствует.If drive существует NULL или указывает на пустую строку, буква диска отображаются в составной path строка.
[входящий] dir
Содержит путь к каталогам, не включая обозначение диска или фактическое имя файла.Конечный косая черта является необязательной, и передняя косая черта (/), обратная косая черта (\), либо могут использоваться в одном dir аргумент.Если отсутствует замыкающий косая черта (/\) не указана, она вставляется автоматически.If dir существует NULL или указывает на пустую строку, формирование путь к каталогу вставляются в составной path строка.
[входящий] fname
Содержит базовое имя файла без расширения имени файла.If fname существует NULL или указывает на пустую строку, имя файла вставляются в составной path строка.
[входящий] ext
Содержит фактическое расширение имени файла, с или без ведущих точки (.)._makepath_s вводит точку автоматически, если он не отображается в ext.If ext существует NULL или указывает на пустую строку, ни одно из расширений вставляются в составной path строка.

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

Нуль, если выполнение прошло успешно; код ошибки при сбое.

Условия возникновения ошибок

path	sizeInWords / sizeInBytes	Return	Содержимое path
NULL	any	EINVAL	не было
any	<= 0	EINVAL	не было

Если либо выше условиях возникновения ошибки, вызывающие эти функции недопустимы обработчик параметра, как описано в разделе Проверка параметров.Если выполнение может продолжить, errno равноEINVAL и функции возвращаютEINVAL**.** NULL позволяет параметров drive" fnameи ext.Дополнительные сведения о расширениях функциональности, когда эти параметры указатели null или пустых строк см. в разделе " примечания ".

Заметки

_makepath_s функция создает составная строка пути, из отдельных компонентов, результат in path.path может включать букву диска, путь к каталогу, имя файла и расширение имени файла._wmakepath_s версия расширенных символов _makepath_s; аргументы _wmakepath_s характерные черты._wmakepath_s и _makepath_s поступайте совпадают, в противном случае.

Сопоставления подпрограммы Родов-Текста

Подпрограмма Tchar.h	Не указанные _UNICODE и _MBCS	Указанный символ _MBCS	Указанный _UNICODE
_tmakepath_s	_makepath_s	_makepath_s	_wmakepath_s

path аргумент должен указывать на пустой буфер недостаточно большой, чтобы поддерживать полный путь.Составной path должно быть не больше _MAX_PATH константа, определенная в Stdlib.h.

Если путь NULLнедопустимый параметр, обработчик вызывается, как описано в разделе Проверка параметров.Кроме того, errno равно EINVAL.NULL значения допускаются для всех прочих параметров.

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

Отладочной версии этих функций сначала заполняют буфер с 0xFD.Чтобы отключить эту реакция на событие, воспользуйтесь _CrtSetDebugFillThreshold.

Требования

Процедура	Обязательный заголовок
_makepath_s	<stdlib.h>
_wmakepath_s	<stdlib.h> OR <wchar.h>

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

Пример

// crt_makepath_s.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];
   errno_t err;

   err = _makepath_s( path_buffer, _MAX_PATH, "c", "\\sample\\crt\\",
                      "crt_makepath_s", "c" );
   if (err != 0)
   {
      printf("Error creating path. Error code %d.\n", err);
      exit(1);
   }
   printf( "Path created with _makepath_s: %s\n\n", path_buffer );
   err = _splitpath_s( path_buffer, drive, _MAX_DRIVE, dir, _MAX_DIR, fname,
                       _MAX_FNAME, ext, _MAX_EXT );
   if (err != 0)
   {
      printf("Error splitting the path. Error code %d.\n", err);
      exit(1);
   }
   printf( "Path extracted with _splitpath_s:\n" );
   printf( "  Drive: %s\n", drive );
   printf( "  Dir: %s\n", dir );
   printf( "  Filename: %s\n", fname );
   printf( "  Ext: %s\n", ext );
}

Output

Path created with _makepath_s: c:\sample\crt\crt_makepath_s.c

Path extracted with _splitpath_s:
  Drive: c:
  Dir: \sample\crt\
  Filename: crt_makepath_s
  Ext: .c