标签：des   style   http   color   java   使用   os   io   

函数原型：

函数原型：
errno_t _splitpath_s(
   const char * path,
   char * drive,
   size_t driveNumberOfElements,
   char * dir,
   size_t dirNumberOfElements,
   char * fname,
   size_t nameNumberOfElements,
   char * ext,
   size_t extNumberOfElements
);
errno_t _wsplitpath_s(
   const wchar_t * path,
   wchar_t * drive,
   size_t driveNumberOfElements,
   wchar_t *dir,
   size_t dirNumberOfElements,
   wchar_t * fname,
   size_t nameNumberOfElements,
   wchar_t * ext,
   size_t extNumberOfElements
); 

参数：

[in] path

  全路径

[out] drive

  驱动器号，后跟一个冒号(:)，如果你不需要驱动器号，可以传递NULL

[in] driveNumberOfElements

   Drive的缓冲区大小（单字节或款字节），如果drive为NULL，该参数必须为0

[out] dir

   目录路径，包括尾部的斜杠，可以使用“\”,“/”或者都使用，如果不需要目录路径，可以传递NULL

[in] dirNumberOfElements

   Dir的缓冲区大小（单字节或者款字节），如果dir为NULL,该参数必须为0

[out] fname

   不带扩展名的文件名，如果不需要文件名，可以传递NULL

[in] nameNumberOfElements

   Fname的缓冲区大小（单字节或者宽字节），如果fname为NULL，该参数必须为0

[out] ext

   文件的扩展名，包括“.”,如果不需要扩展名，可以传递NULL

[in] extNumberOfElements

   Ext的缓冲区大小（单字节或者宽字节），如果ext为NULL，该参数必须为0

返回值：

成功返回0，失败返回错误代码 EINVAL

错误的情况有：

任何一个指针指向空，那么对应的缓冲区必须为0，否者调用失败，返回EINVAL。

如果任何一个缓冲区太短而无法包含结果，那么该函数会清空所有缓冲区指向空。设置errno 为ERANGE，并返回ERANGE。

注意：

_splitpath_s 该函数将全路径分割成四个部分，分别是驱动器，路径名，文件名（不带扩展名），扩展名。_splitpath_s会根据当前正在使用的多字节页码来识别多字节字符来处理宽字节字符串。_wsplitpath_s是_splitpath_s的多字节版本，_wsplitpath_s的参数是宽字符。

全路径被分成四个部分分别存储在不同的缓冲区中，每个部分允许的最大值为_MAX_DRIVE, _MAX_DIR,_MAX_FNAME, and_MAX_EXT，这些宏定义在stdlib.h中，如果这四个部分的缓冲区大小超过了定义的允许的最大值，那么会引起heap corruption.

以下是四个宏的定义的最大值：

如果全路径中缺少一个部分（例如没有文件名）_splitpath_s会为对应的缓冲区赋值为空。

头文件：

// tchar.h 中的宏定义

#define _tsplitpath     _splitpath

#define _tsplitpath_s   _splitpath_s

代码例子：

void MXSPLITPATH_S(const TCHAR* szFullPath, TCHAR* szDrive, TCHAR* szDir, TCHAR* szFileName, TCHAR* szExt)   

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

// 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 );
}

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

_tsplitpath_s(分解路径) _tmakepath_s(创建路径),布布扣,bubuko.com

_tsplitpath_s(分解路径) _tmakepath_s(创建路径)

标签：des   style   http   color   java   使用   os   io   

原文地址：http://www.cnblogs.com/leadtheway/p/3911447.html