_splitpath_s、_wsplitpath_s

發行項
06/09/2015

分解路徑名稱至元件。這些是 _splitpath, _wsplitpath 的安全性增強版本，如CRT 中的安全性功能中所述。

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
);
template <size_t drivesize, size_t dirsize, size_t fnamesize, size_t extsize>
errno_t _splitpath_s(
   const char *path,
   char (&drive)[drivesize],
   char (&dir)[dirsize],
   char (&fname)[fnamesize],
   char (&ext)[extsize]
); // C++ only
template <size_t drivesize, size_t dirsize, size_t fnamesize, size_t extsize>
errno_t _wsplitpath_s(
   const wchar_t *path,
   wchar_t (&drive)[drivesize],
   wchar_t (&dir)[dirsize],
   wchar_t (&fname)[fnamesize],
   wchar_t (&ext)[extsize]
); // C++ only

參數

[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。

傳回值

如果成功，就是零，如果失敗，則為錯誤碼。

錯誤狀況

條件	傳回值
path 為 NULL	EINVAL
drive 是 NULL， driveNumberOfElements 為非零	EINVAL
drive 是非 NULL， driveNumberOfElements 為零	EINVAL
dir 是 NULL， dirNumberOfElements 為非零	EINVAL
dir 是非 NULL， dirNumberOfElements 為零	EINVAL
fname 是 NULL， nameNumberOfElements 為非零	EINVAL
fname 是非 NULL， nameNumberOfElements 為零	EINVAL
ext 是 NULL， extNumberOfElements 為非零	EINVAL
ext 是非 NULL， extNumberOfElements 為零	EINVAL

如果以上任何一個錯誤情況發生，無效的參數叫用處理常式，如參數驗證中所述。如果允許繼續執行，這些函式會將 errno 設定為 EINVAL 並傳回 EINVAL。

如果任何緩衝區太小而無法保存這個結果，這些函式清除所有緩衝區初始化為空字串，將 errno 設為 ERANGE並傳回 ERANGE。

備註

_splitpath_s 函式將路徑分給它的四個元件。 _splitpath_s 適時地自動處理多位元組字元的字串參數，根據目前使用的多位元組字碼頁來辨認多位元組字元序列。 _wsplitpath_s 是 _splitpath_s 的寬字元版本；_wsplitpath_s 的引數是寬字元字串。這些函式其餘部分的運作相同。

一般文字常式對應