C++Builderでのファイル名及びフォルダ操作ルーチンの説明

C++Builderで、ファイル名及びフォルダ操作ルーチンに関する情報（ヘルプ）がありましたので、以下にまとめました。また、使い方のサンプルコードを追加しました。

代表的な関数の使い方
関数の一覧
参考URL

代表的な関数の使い方

拡張子の変更

拡張子を変更します。Application->ExeNameは、アプリケーションの実行ファイル名です。

ChangeFileExt関数を使用

Extension は，新しい拡張子（最初のドット文字を含む）を指定します。

// インクルードファイル
#include <System.SysUtils.hpp>

// 使用例
String inifname			= ChangeFileExt(Application->ExeName, ".ini");

TPath::ChangeExtension関数の使用

TPath::ChangeExtension関数の使用

その拡張子を、Extension パラメータで渡された拡張子に変更します。指定された新しい拡張子には、先頭のピリオドを含めてもかまいません。

// インクルードファイル
#include <System.IOUtils.hpp>

// 使用例
String inifname			= TPath::ChangeExtension(Application->ExeName, ".ini");

ファイル名のパスの変更します。

	String fname = ChangeFilePath(Application->ExeName, GetHomePath());

実行ファイルと同じフォルダ内のファイル名を生成

IncludeTrailingPathDelimiter は、パス名の末尾に必ず区切り記号を追加する関数です。フォルダパスとファイル名を組み合わせてパスを作成する際にこの関数を使用すると便利です。

ExtractFileDir関数使用時

	String fname 	= ExtractFileDir(Application->ExeName);
	fname			= IncludeTrailingPathDelimiter(fname) + "TestFile.txt";

TPath::GetDirectoryName使用時

	String fname 	= TPath::GetDirectoryName(Application->ExeName);
	fname			= IncludeTrailingPathDelimiter(fname) + "TestFile.txt";

ファイルの各要素の取得

System.SysUtils を使用した場合

    String wstr;
	
    // ファイル名のドライブ部分を返します。
	wstr	= ExtractFileDrive(Application->ExeName);
	Memo1->Lines->Add(wstr);

	// ファイル名の拡張子部分を返します。(実行ファイルであれは、".exe")
	wstr	= ExtractFileExt(Application->ExeName);
	Memo1->Lines->Add(wstr);

	// ファイル名の名前部分と拡張子部分を抽出します。
	wstr	= ExtractFileName(Application->ExeName);
	Memo1->Lines->Add(wstr);

	// ファイル名のドライブ部分とディレクトリ部分を返します。（パス名の末尾に、区切り記号が付きます。）
	wstr	= ExtractFilePath(Application->ExeName);
	Memo1->Lines->Add(wstr);

TPathクラスの関数を使用した場合

    String wstr;

	// ファイル名のドライブ部分とディレクトリ部分を抽出します。
	wstr	= TPath::GetDirectoryName(Application->ExeName);
	Memo1->Lines->Add(wstr);

	// ファイル名の拡張子部分を抽出します。
	wstr	= TPath::GetExtension(Application->ExeName);
	Memo1->Lines->Add(wstr);

	// ファイル名の名前部分と拡張子部分を抽出します。
	wstr	= TPath::GetFileName(Application->ExeName);
	Memo1->Lines->Add(wstr);

	// ファイル名の名前部分（拡張子を除く）を抽出します。
	wstr	= TPath::GetFileNameWithoutExtension(Application->ExeName);
	Memo1->Lines->Add(wstr);

指定したファイルが存在するかどうかを判定

FileExistsを使用

	if(FileExists(Application->ExeName))
	{
		Memo1->Lines->Add("ファイルあり");
	} else {
		Memo1->Lines->Add("ファイルなし");
	}

TFile::Existsを使用

	if(TFile::Exists(Application->ExeName))
	{
		Memo1->Lines->Add("ファイルあり");
	} else {
		Memo1->Lines->Add("ファイルなし");
	}

指定したディレクトリが存在するかどうかを判定

DirectoryExists関数を使用します。パス名の末尾の区切り記号の有無に関係なく使用できます。

DirectoryExists

    String path	= ExtractFilePath(Application->ExeName);
	if(DirectoryExists(path))
	{
		Memo1->Lines->Add("フォルダあり");
	} else {
		Memo1->Lines->Add("フォルダなし");
	}

TDirectory::Exists

    String path	= TPath::GetDirectoryName(Application->ExeName);    
	if(TDirectory::Exists(path))
	{
		Memo1->Lines->Add("フォルダあり");
	} else {
		Memo1->Lines->Add("フォルダなし");
	}

ユーザーのホームパスの取得

	// ユーザーのホーム パスを返します。
	String HomePath	= GetHomePath();

取得できる各プラッチフォームのホームパスです。

プラットフォーム	ホームパス
Windows XP	C:\Documents and Settings\\Application Data
Windows Vista 以降	C:\Users\\AppData\Roaming
OS X	/Users/
iOS デバイス	/private/var/mobile/Containers/Data/Application/
iOS シミュレータ	/Users//Library/Developer/CoreSimulator/Devices//data/Containers/Data/Application/
Android	/data/data//files
Linux	/home/

GetHomePathで取得する各プラットフォームでのユーザーのホームパス

ファイルまたはディレクトリ属性の取得

TPath::GetAttributesを使用して、ファイルまたはディレクトリ属性を取得することが出来ます。

	// ファイルまたはディレクトリ属性を返します。
	TFileAttributes attributes = TPath::GetAttributes(Application->ExeName);

    // 属性をチェック
    if (attributes.Contains(TFileAttribute::faReadOnly)) 
    {
		Memo1->Lines->Add(L"読み取り専用ファイルです。");
    }
    if (attributes.Contains(TFileAttribute::faHidden)) 
    {
		Memo1->Lines->Add(L"隠しファイルです。");
    }
	if (attributes.Contains(TFileAttribute::faSystem))
    {
		Memo1->Lines->Add(L"システムファイルです。");
    }
    if (attributes.Contains(TFileAttribute::faDirectory)) 
    {
		Memo1->Lines->Add(L"ディレクトリです。");
    }
    if (attributes.Contains(TFileAttribute::faArchive)) 
    {
		Memo1->Lines->Add(L"アーカイブファイルです。");
    }
    if (attributes.Contains(TFileAttribute::faNormal)) 
    {
		Memo1->Lines->Add(L"通常ファイルです。");
    }

Windows の場合、TFileAttribute の取り得る値

値	意味
faReadOnly	読み取り専用ファイルまたは読み取り専用ディレクトリであることを示します。
faHidden	隠しファイルまたは隠しディレクトリであることを示します。
faSystem	システムファイルまたはシステムディレクトリであることを示します。
faDirectory	ディレクトリであることを示します。
faArchive	Windows アーカイブファイルであることを示します。
faDevice	Windows デバイスファイルであることを示します。
faNormal	通常のファイルであることを示します。
faTemporary	一時ファイルまたは一時ディレクトリであることを示します。
faSparseFile	スパースファイルであることを示します。スパースファイルとは、ほとんどゼロで埋められた大きいファイルのことです。
faReparsePoint	再解析ポイントであることを示します。再解析ポイントとは、実際のファイルまたはディレクトリにリンクしているユーザー定義データブロックのことです。
faCompressed	圧縮ファイルまたは圧縮ディレクトリであることを示します。
faOffline	内容が使用不能なオフラインファイルであることを示します。
faNotContentIndexed	インデックス付け操作を省略されたファイルであることを示します。
faEncrypted	暗号化されたファイルまたはディレクトリであることを示します。
faSymLink	シンボリックリンクであることを示します。

System.IOUtils.TFileAttribute

POSIX の場合、TFileAttribute の取り得る値。

値	意味
faNamedPipe	名前付きパイプ（FIFO）であることを示します。名前付きパイプは、あるプロセスから別のプロセスに情報を転送するためなどに使用することができます。
faCharacterDevice	キャラクタデバイス（順に読み取らなければならないデータフローを提供するファイル記述子）であることを示します。キャラクタデバイスの例には、キーが押されると次の文字が読み取られる端末などがあります。
faDirectory	ディレクトリであることを示します。
faBlockDevice	ブロックデバイスであることを示します。ブロックデバイスとキャラクタデバイスの違いは、ブロックデバイスにはリクエスト用のバッファがあるため、どの順序で応答するかを選択できることです。
faNormal	通常のファイルであることを示します。
faSymLink	シンボリックリンク（別のファイルやディレクトリの参照を絶対パスまたは相対パスの形式で含むファイル記述子）であることを示します。
faSocket	ソケットであることを示します。
faWhiteout	ホワイトアウトファイル（存在しないためそれに対して操作を実行することができないファイル）であることを示します。
faOwnerRead	所有者はファイル記述子を読み取ることができます。
faOwnerWrite	所有者はファイル記述子に書き込むことができます。
faOwnerExecute	所有者はファイル記述子を実行することができます。
faGroupRead	グループ内のすべてのユーザーがファイル記述子を読み取ることができます。
faGroupWrite	グループ内のすべてのユーザーがファイル記述子に書き込むことができます。
faGroupExecute	グループ内のすべてのユーザーがファイル記述子を実行することができます。
faOthersRead	所有者以外のユーザーがファイル記述子を読み取ることができます。
faOthersWrite	所有者以外のユーザーがファイル記述子に書き込むことができます。
faOthersExecute	所有者以外のユーザーがファイル記述子を実行することができます。
faUserIDExecution	実行中のユーザー ID。実行できるよう昇格される場合があります。
faGroupIDExecution	実行中のグループ ID。実行できるよう昇格される場合があります。
faStickyBit	所有者以外のプロセスがファイルを削除できないようにします。

シンボリックリンクの作成

TFile::CreateSymLinkを使用して、シンボリックリンクを作成する事ができます。以下は、デスクトップにアプリケーションのシンボリックリンクを作成するサンプルコードです。

SHGetFolderPathW関数（API）で、デスクトップのフォルダ名を取得しています。

以下、注意事項です。

ンボリックリンクを作成するには、管理者権限が必要です。プログラムを管理者として実行してください。
リンク対象ファイルまたはディレクトリは、CreateSymLink の呼び出し時には存在していなければなりません。

CreateSymLink は、Windows Vista 以降の Windows 版でのみ使用できます。

#include <stdio.h>
#include <System.SysUtils.hpp>

    // -----------------------------------------------------
	String TargetApp = Application->ExeName;

    // デスクトップのパスを取得
	wchar_t desktopPath[MAX_PATH];
    if (SHGetFolderPathW(NULL, CSIDL_DESKTOP, NULL, 0, desktopPath) != S_OK)
    {
        ShowMessage(L"デスクトップのパスを取得できませんでした。");
        return ;
    } else {
		 Memo1->Lines->Add(desktopPath);
	}

    // シンボリックリンクのパスを設定
    String linkPath = String(desktopPath) + L"\\MyApp.lnk";
	bool ret = TFile::CreateSymLink(linkPath, TargetApp);
	if(ret)
	{
		 Memo1->Lines->Add(L"シンボリックリンクの作成に成功しました！");
	} else {
        DWORD error = GetLastError();
		wstr	= (String)"シンボリックリンクの作成に失敗しました。エラーコード: " + IntToStr((int)error);
		Memo1->Lines->Add(wstr);
	}

関数の一覧

System.SysUtils

System.SysUtilsで、定義されているファイル名及びフォルダ操作関係の関数一覧です。

昔からある、関数です。

メンバ	説明
System.SysUtils.AnsiCompareFileName	現在のロケールに基づいてファイル名を比較します。
System.SysUtils.AnsiLowerCaseFileName	ファイル名を小文字に変換します。
System.SysUtils.ChangeFileExt	ファイル名の拡張子を変更します。
System.SysUtils.ChangeFilePath	ファイル名のパスを変更します。
System.SysUtils.DirectoryExists	指定したディレクトリが存在するかどうかを判定します。
System.SysUtils.ExcludeTrailingBackslash	末尾に区切り記号が付いていないパス名を返します。（後方互換性のため）
System.SysUtils.ExcludeTrailingPathDelimiter	末尾に区切り記号が付いていないパス名を返します。（こちを推奨）
System.SysUtils.ExpandFileName	相対ファイル名の完全パス名を返します。
System.SysUtils.ExpandFileNameCase	大文字と小文字を区別するファイルシステム上の相対ファイル名の完全パス名を返します。
System.SysUtils.ExpandUNCFileName	適切な場合、UNC 形式のファイル名の完全パスを返します。
System.SysUtils.ExtractFileDir	ファイル名からドライブ部分とディレクトリ部分を抜き出します。
System.SysUtils.ExtractFileDrive	ファイル名のドライブ部分を返します。
System.SysUtils.ExtractFileExt	ファイル名の拡張子部分を返します。
System.SysUtils.ExtractFileName	ファイル名の名前部分と拡張子部分を抽出します。
System.SysUtils.ExtractFilePath	ファイル名のドライブ部分とディレクトリ部分を返します。
System.SysUtils.ExtractRelativePath	特定のベースディレクトリからの相対パス名を返します。
System.SysUtils.ExtractShortPathName	ファイル名を短い 8.3 形式に変換します。
System.SysUtils.IncludeTrailingBackslash	パス名の末尾が必ず区切り記号になるようにします。（後方互換性のため）
System.SysUtils.IncludeTrailingPathDelimiter	パス名の末尾が必ず区切り記号になるようにします。（こちを推奨）
System.SysUtils.IsPathDelimiter	文字列内の指定位置にあるバイトデータがパス区切り記号かどうかを示します。
System.SysUtils.SameFileName	現在のロケールに基づいてファイル名を比較します。

System.IOUtils.TPath

Delphi 2010以降に追加された関数（TPathクラス）です。

FMXとの互換性を考慮する場合は、こちらを使った方が良いかと思います。

FMXでは、FMX.Objects.TPath　で定義されています。

メンバ	説明
System.IOUtils.TPath.ChangeExtension	指定されたパスで示されるファイルまたはディレクトリの拡張子を変更します。
System.IOUtils.TPath.Combine	2 つのパス文字列を結合します。
System.IOUtils.TPath.DriveExists	指定されたパスで使用されているドライブ文字が実際に存在するかどうかを確かめます。
System.IOUtils.TPath.GetAttributes	ファイルまたはディレクトリ属性を返します。
System.IOUtils.TPath.GetDirectoryName	ファイル名のドライブ部分とディレクトリ部分を抽出します。
System.IOUtils.TPath.GetExtendedPrefix	指定されたパスの拡張プレフィックスタイプを返します。
System.IOUtils.TPath.GetExtension	ファイル名の拡張子部分を抽出します。
System.IOUtils.TPath.GetFileName	ファイル名の名前部分と拡張子部分を抽出します。
System.IOUtils.TPath.GetFileNameWithoutExtension	ファイル名の名前部分（拡張子を除く）を抽出します。
System.IOUtils.TPath.GetFullPath	指定されたパスの絶対パスを返します。
System.IOUtils.TPath.GetGUIDFileName	一意なファイル名として使用できる新しい GUID を生成します。
System.IOUtils.TPath.GetHomePath	ユーザーのホームパスを返します。
System.IOUtils.TPath.GetRandomFileName	ランダムなファイル名を新たに生成します。
System.IOUtils.TPath.GetTempFileName	一意な一時ファイルを生成します。
System.IOUtils.TPath.GetTempPath	システムの一時ディレクトリへのパスを返します。
System.IOUtils.TPath.HasExtension	指定されたファイル名に拡張子部分があるかどうかを確かめます。
System.IOUtils.TPath.HasValidFileNameChars	指定されたファイル名が使用可能な文字だけで構成されているかどうかを確かめます。
System.IOUtils.TPath.HasValidPathChars	指定されたパス文字列が使用可能な文字だけで構成されているかどうかを確かめます。
System.IOUtils.TPath.IsDriveRooted	指定されたパスがドライブ文字で始まる絶対パスかどうかを確かめます。
System.IOUtils.TPath.IsExtendedPrefixed	指定されたパスに拡張プレフィックスが含まれているかどうかを確かめます。
System.IOUtils.TPath.IsPathRooted	指定されたパスが相対パスか絶対パスかを確かめます。
System.IOUtils.TPath.IsUNCPath	指定されたパスが UNC（Universal Naming Convention：汎用命名規則）形式かどうかを確かめます。
System.IOUtils.TPath.IsUNCRooted	指定されたパスが UNCルート形式かどうかを確かめます（UNC は、汎用命名規則（Universal Naming Convention）を表す）。
System.IOUtils.TPath.IsValidFileNameChar	指定された文字がファイル名で使用可能かどうかを確かめます。
System.IOUtils.TPath.IsValidPathChar	指定された文字がパス文字列で使用可能かどうかを確かめます。
System.IOUtils.TPath.SetAttributes	ファイルまたはディレクトリ属性を設定します。