_splitpath, _wsplitpath

提供: RAD Studio
移動先: 案内検索

stdlib.h:インデックス への移動


ヘッダーファイル

stdlib.h

カテゴリ

ディレクトリ制御ルーチン

プロトタイプ

void _splitpath(const char *path, char *drive, char *dir, char *name, char *ext);

void _wsplitpath(const wchar_t *path, wchar_t *drive, wchar_t *dir, wchar_t *name, wchar_t *ext);

説明

絶対パス名を構成要素に分割します。

_splitpath は,ファイルの絶対パス名(path)を次の形式の文字列として受け取ります。

X:\DIR\SUBDIR\NAME.EXT

次に,パスを 4 つの部分に分割します。次に,これらの構成要素を drive,dir,name,および ext が指す文字列に格納します。5 つすべての構成要素を渡す必要があります。ただし,それらはヌルでもかまいません。その場合,ヌルの構成要素は解析されますが,格納されません。これらの文字列の最大サイズは,定数 _MAX_DRIVE,_MAX_DIR,_MAX_PATH,_MAX_FNAME,および _MAX_EXT(stdlib.h で定義)で指定されます。各サイズには,ヌルターミネータのスペースが含まれます。これらの定数は stdlib.h で定義されています。

_MAX_PATH

パス

_MAX_DRIVE

ドライブ(コロン : を含む)

_MAX_DIR

ディレクトリ(前後に円記号 \ を含む)

_MAX_FNAME

名前

_MAX_EXT

拡張子(前にドット . を含む)



_splitpath は,ヌルでない各構成要素を格納できる十分な容量があると仮定します。

_splitpath は,path を分割するときに区切り文字を次のように扱います。

  • drive はコロンを含む(「C:」,「A:」,など)
  • dir は前後に円記号を含む(「\BC\include\」,「\source\」など)
  • name はファイル名を含む
  • ext は拡張子の前にドットを含む(「.C」,「.EXE」など)

_makepath と _splitpath の機能は反対です。パスを _splitpath で分割した場合は,分割された構成要素を _makepath でマージすると,パスが作成されます。

戻り値

なし。

#include <dir.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
  char s[_MAX_PATH];
  char drive[_MAX_DRIVE];
  char dir[_MAX_DIR];
  char file[_MAX_FNAME];
  char ext[_MAX_EXT];
  /* 現在の作業ディレクトリを取得します */
  getcwd(s,_MAX_PATH);
  if (s[strlen(s)-1] != '\\')
  /* 末尾の \ 文字を追加します */
    strcat(s,"\\");
  /* 文字列を個別の要素に分解します */
  _splitpath(s,drive,dir,file,ext);
  strcpy(file,"DATA");
  strcpy(ext,".TXT");
  /* 要素を 1 つの文字列にマージします */
  _makepath(s,drive,dir,file,ext);
  /* 結果の文字列を表示する */
  puts(s);
  return 0;
}

移植性

POSIX Win32 ANSI C ANSI C++

_splitpath

+

_wsplitpath

+