CPathT クラスCPathT Class

このクラスはパスを表します。This class represents a path.

重要

このクラスとそのメンバーは、Windows ランタイムで実行されるアプリケーションでは使用できません。This class and its members cannot be used in applications that execute in the Windows Runtime.

構文Syntax

template <typename StringType>
class CPathT

パラメーターParameters

StringTypeStringType
パスに使用する ATL/MFC 文字列クラス(CStringTを参照)。The ATL/MFC string class to use for the path (see CStringT).

メンバーMembers

パブリック typedefPublic Typedefs

名前Name 説明Description
次のサービスを:PCPathT::PCXSTR 定数文字列型。A constant string type.
:PXSTRCPathT::PXSTR 文字列型。A string type.
CPathT::XCHARCPathT::XCHAR 文字型。A character type.

パブリック コンストラクターPublic Constructors

名前Name 説明Description
Cパス::CパストCPathT::CPathT パスのコンストラクター。The constructor for the path.

パブリック メソッドPublic Methods

名前Name 説明Description
CPathT::バックスラッシュの追加CPathT::AddBackslash 文字列の末尾に円記号を追加して、パスの正しい構文を作成します。Call this method to add a backslash to the end of a string to create the correct syntax for a path.
CPathT::拡張機能の追加CPathT::AddExtension パスにファイル拡張子を追加します。Call this method to add a file extension to a path.
CPathT::追加CPathT::Append 現在のパスに文字列を追加します。Call this method to append a string to the current path.
CPathT::ビルドルートCPathT::BuildRoot 指定したドライブ番号からルート パスを作成します。Call this method to create a root path from a given drive number.
CPathT::正規化CPathT::Canonicalize パスを正規形式に変換します。Call this method to convert the path to canonical form.
CPathT::コンバインCPathT::Combine ディレクトリ名を表す文字列と、ファイル パス名を表す文字列を 1 つのパスに連結します。Call this method to concatenate a string representing a directory name and a string representing a file path name into one path.
CPathT::コモンプレフィックスCPathT::CommonPrefix 指定したパスが現在のパスと共通のプレフィックスを共有しているかどうかを調べます。Call this method to determine whether the specified path shares a common prefix with the current path.
Cパス::コンパクトパスCPathT::CompactPath パス コンポーネントを省略記号で置き換えることによって、指定したピクセル幅に収まるようにファイル パスを切り捨てます。Call this method to truncate a file path to fit within a given pixel width by replacing path components with ellipsis.
CPathT::コンパクトパスエックスCPathT::CompactPathEx パスコンポーネントを省略記号で置き換えることで、指定した文字数に収まるようにファイル パスを切り捨てます。Call this method to truncate a file path to fit within a given number of characters by replacing path components with ellipsis.
CPathT::ファイルは存在しますCPathT::FileExists このパス名のファイルが存在するかどうかを確認します。Call this method to check whether the file at this path name exists.
CPathT::拡張を検索CPathT::FindExtension パス内のファイル拡張子の位置を検索します。Call this method to find the position of the file extension within the path.
ファイル名を検索します。CPathT::FindFileName パス内のファイル名の位置を検索します。Call this method to find the position of the file name within the path.
Cパス::ゲットドライブナンバーCPathT::GetDriveNumber 'A' から 'Z' の範囲内のドライブ文字のパスを検索し、対応するドライブ番号を返します。Call this method to search the path for a drive letter within the range of 'A' to 'Z' and return the corresponding drive number.
CPathT::拡張機能を取得します。CPathT::GetExtension パスからファイル拡張子を取得します。Call this method to get the file extension from the path.
Cパス::イズディレクトリCPathT::IsDirectory パスが有効なディレクトリかどうかを確認します。Call this method to check whether the path is a valid directory.
CPathT::ファイルスペックCPathT::IsFileSpec パス区切り文字 (':' や ' '\など) を検索します。Call this method to search a path for any path-delimiting characters (for example, ':' or '\' ). パス区切り文字が存在しない場合、パスはファイル仕様パスと見なされます。If there are no path-delimiting characters present, the path is considered to be a File Spec path.
Cパス::IsプレフィックスCPathT::IsPrefix パスに、pszPrefixによって渡される型の有効なプレフィックスが含まれているかどうかを調べます。Call this method to determine whether a path contains a valid prefix of the type passed by pszPrefix.
Cパス::イズ相対CPathT::IsRelative パスが相対パスかどうかを調べます。Call this method to determine if the path is relative.
CPathT::イズルートCPathT::IsRoot パスがディレクトリ ルートかどうかを調べます。Call this method to determine if the path is a directory root.
CPathT::イササミルートCPathT::IsSameRoot 現在のパスを持つ共通のルート コンポーネントが別のパスにあるかどうかを調べます。Call this method to determine whether another path has a common root component with the current path.
CPathT::IsUNCCPathT::IsUNC パスがサーバーと共有の有効な UNC (汎用名前付け規則) パスであるかどうかを確認します。Call this method to determine whether the path is a valid UNC (universal naming convention) path for a server and share.
Cパス::サーバーCPathT::IsUNCServer パスがサーバーのみの有効な UNC (汎用名前付け規則) パスであるかどうかを確認します。Call this method to determine whether the path is a valid UNC (universal naming convention) path for a server only.
Cパス::サーバーシェアCPathT::IsUNCServerShare パスが有効な UNC \ \ (汎用名前付け規則) 共有パスである\ サーバー共有かどうかを確認します。Call this method to determine whether the path is a valid UNC (universal naming convention) share path, \\ server\ share.
Cパス::メイクプリティCPathT::MakePretty パスをすべての小文字に変換して、パスの外観に一貫性を持たせる場合に、このメソッドを呼び出します。Call this method to convert a path to all lowercase characters to give the path a consistent appearance.
Cパス:マッチスペックCPathT::MatchSpec ワイルドカード一致の種類を含む文字列のパスを検索します。Call this method to search the path for a string containing a wildcard match type.
CPathT::引用スペースCPathT::QuoteSpaces パスにスペースが含まれている場合は、このメソッドを呼び出して、パスを引用符で囲みます。Call this method to enclose the path in quotation marks if it contains any spaces.
Cパス::相対パスCPathT::RelativePathTo あるファイルまたはフォルダーから別のファイルまたはフォルダーへの相対パスを作成します。Call this method to create a relative path from one file or folder to another.
CPathT::削除引数CPathT::RemoveArgs パスからコマンド ライン引数を削除します。Call this method to remove any command-line arguments from the path.
CPathT::削除バックスラッシュCPathT::RemoveBackslash パスから末尾の円記号を削除します。Call this method to remove the trailing backslash from the path.
CPathT::ブランクの削除CPathT::RemoveBlanks パスから先頭と末尾の空白をすべて削除します。Call this method to remove all leading and trailing spaces from the path.
CPathT::拡張機能の削除CPathT::RemoveExtension パスからファイル拡張子を削除します (存在する場合)。Call this method to remove the file extension from the path, if there is one.
ファイルの削除CPathT::RemoveFileSpec パスに末尾のファイル名と円記号がある場合は、このメソッドを呼び出します。Call this method to remove the trailing file name and backslash from the path, if it has them.
CPathT::拡張機能の名前の変更CPathT::RenameExtension パス内のファイル名拡張子を新しい拡張子で置き換えます。Call this method to replace the file name extension in the path with a new extension. ファイル名に拡張子が含まれていない場合、拡張子は文字列の末尾に付加されます。If the file name does not contain an extension, the extension will be attached to the end of the string.
CPathT::スキップルートCPathT::SkipRoot ドライブ文字または UNC サーバー/共有パスの部分を無視してパスを解析します。Call this method to parse a path, ignoring the drive letter or UNC server/share path parts.
Cパス::ストリップパスCPathT::StripPath 完全修飾パスとファイル名のパス部分を削除します。Call this method to remove the path portion of a fully qualified path and file name.
CPathT::ストリップトルートCPathT::StripToRoot ルート情報を除くパスのすべての部分を削除します。Call this method to remove all parts of the path except for the root information.
CPathT::クォートなしスペースCPathT::UnquoteSpaces パスの先頭と末尾から引用符を削除します。Call this method to remove quotation marks from the beginning and end of a path.

パブリック演算子Public Operators

名前Name 説明Description
&型を指定します。CPathT::operator const StringType & この演算子を使用すると、オブジェクトを文字列として扱うことができます。This operator allows the object to be treated like a string.
CPathT::オペレーター CPathT::PCXSTRCPathT::operator CPathT::PCXSTR この演算子を使用すると、オブジェクトを文字列として扱うことができます。This operator allows the object to be treated like a string.
&型の演算子CPathT::operator StringType & この演算子を使用すると、オブジェクトを文字列として扱うことができます。This operator allows the object to be treated like a string.
CPathT::演算子 +=CPathT::operator += この演算子は、パスに文字列を追加します。This operator appends a string to the path.

パブリック データ メンバーPublic Data Members

名前Name 説明Description
CPathT::m_strPathCPathT::m_strPath パス。The path.

解説Remarks

CPath、、CPathAおよびCPathWは次のようにCPathT定義されたインスタンス化です。CPath, CPathA, and CPathW are instantiations of CPathT defined as follows:

typedef CPathT< CString > CPath;

typedef CPathT< CStringA > CPathA;

typedef CPathT< CStringW > CPathW;

必要条件Requirements

ヘッダー: atlpath.hHeader: atlpath.h

CPathT::バックスラッシュの追加CPathT::AddBackslash

文字列の末尾に円記号を追加して、パスの正しい構文を作成します。Call this method to add a backslash to the end of a string to create the correct syntax for a path. パスに既に末尾の円記号がある場合、バックスラッシュは追加されません。If the path already has a trailing backslash, no backslash will be added.

void AddBackslash();

解説Remarks

詳細については、「パスの追加バックスラッシュ」を参照してください。For more information, see PathAddBackSlash.

CPathT::拡張機能の追加CPathT::AddExtension

パスにファイル拡張子を追加します。Call this method to add a file extension to a path.

BOOL AddExtension(PCXSTR pszExtension);

パラメーターParameters

拡張pszExtension
追加するファイル拡張子。The file extension to add.

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パスの追加拡張機能」を参照してください。For more information, see PathAddExtension.

CPathT::追加CPathT::Append

現在のパスに文字列を追加します。Call this method to append a string to the current path.

BOOL Append(PCXSTR pszMore);

パラメーターParameters

pszもっとpszMore
追加する文字列。The string to append.

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パスの追加」を参照してください。For more information, see PathAppend.

CPathT::ビルドルートCPathT::BuildRoot

指定したドライブ番号からルート パスを作成します。Call this method to create a root path from a given drive number.

void BuildRoot(int iDrive);

パラメーターParameters

IdriveiDrive
ドライブ番号 (0 は A:、1 は B:、など)。The drive number (0 is A:, 1 is B:, and so on).

解説Remarks

詳細については、「パスビルドルート」を参照してください。For more information, see PathBuildRoot.

CPathT::正規化CPathT::Canonicalize

パスを正規形式に変換します。Call this method to convert the path to canonical form.

void Canonicalize();

解説Remarks

詳細については、「パス正規化」を参照してください。For more information, see PathCanonicalize.

CPathT::コンバインCPathT::Combine

ディレクトリ名を表す文字列と、ファイル パス名を表す文字列を 1 つのパスに連結します。Call this method to concatenate a string representing a directory name and a string representing a file path name into one path.

void Combine(PCXSTR pszDir, PCXSTR  pszFile);

パラメーターParameters

を使用します。pszDir
ディレクトリのパスです。The directory path.

ファイルpszFile
ファイル パス。The file path.

解説Remarks

詳細については、「 PathCombine」を参照してください。For more information, see PathCombine.

CPathT::コモンプレフィックスCPathT::CommonPrefix

指定したパスが現在のパスと共通のプレフィックスを共有しているかどうかを調べます。Call this method to determine whether the specified path shares a common prefix with the current path.

CPathT<StringType> CommonPrefix(PCXSTR pszOther);

パラメーターParameters

その他pszOther
現在のパスと比較するパス。The path to compare to the current one.

戻り値Return Value

共通のプレフィックスを返します。Returns the common prefix.

解説Remarks

接頭辞は次のタイプの 1\\つです。\\".A prefix is one of these types: "C:\\", ".", "..", "..\\". 詳細については、「パスコモン プレフィックス」を参照してください。For more information, see PathCommonPrefix.

Cパス::コンパクトパスCPathT::CompactPath

パス コンポーネントを省略記号で置き換えることによって、指定したピクセル幅に収まるようにファイル パスを切り捨てます。Call this method to truncate a file path to fit within a given pixel width by replacing path components with ellipsis.

BOOL CompactPath(HDC hDC, UINT nWidth);

パラメーターParameters

HdchDC
フォント メトリックに使用されるデバイス コンテキスト。The device context used for font metrics.

n幅nWidth
文字列が強制的に収まる幅 (ピクセル単位)。The width, in pixels, that the string will be forced to fit in.

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パスのパスをパスパス」を参照してください。For more information, see PathCompactPath.

CPathT::コンパクトパスエックスCPathT::CompactPathEx

パスコンポーネントを省略記号で置き換えることで、指定した文字数に収まるようにファイル パスを切り捨てます。Call this method to truncate a file path to fit within a given number of characters by replacing path components with ellipsis.

BOOL CompactPathEx(UINT nMaxChars, DWORD dwFlags = 0);

パラメーターParameters

nMaxCharsnMaxChars
新しい文字列に含まれる最大文字数 (終端の NULL 文字を含む)。The maximum number of characters to be contained in the new string, including the terminating NULL character.

dwFlagsdwFlags
予約済み。Reserved.

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パスパスパス」を参照してくださいFor more information, see PathCompactPathEx.

Cパス::CパストCPathT::CPathT

コンストラクターです。The constructor.

CPathT(PCXSTR pszPath);
CPathT(const CPathT<StringType>& path);
CPathT() throw();

パラメーターParameters

パスpszPath
パス文字列へのポインター。The pointer to a path string.

pathpath
パス文字列。The path string.

CPathT::ファイルは存在しますCPathT::FileExists

このパス名のファイルが存在するかどうかを確認します。Call this method to check whether the file at this path name exists.

BOOL FileExists() const;

戻り値Return Value

ファイルが存在する場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the file exists, FALSE otherwise.

解説Remarks

詳細については、「パスファイルが存在する」を参照してください。For more information, see PathFileExists.

CPathT::拡張を検索CPathT::FindExtension

パス内のファイル拡張子の位置を検索します。Call this method to find the position of the file extension within the path.

int FindExtension() const;

戻り値Return Value

拡張子の前の "." の位置を返します。Returns the position of the "." preceding the extension. 拡張子が見つからない場合は、-1 を返します。If no extension is found, returns -1.

解説Remarks

詳細については、「パス検索拡張機能」を参照してください。For more information, see PathFindExtension.

ファイル名を検索します。CPathT::FindFileName

パス内のファイル名の位置を検索します。Call this method to find the position of the file name within the path.

int FindFileName() const;

戻り値Return Value

ファイル名の位置を返します。Returns the position of the file name. ファイル名が見つからない場合は、-1 を返します。If no file name is found, returns -1.

解説Remarks

詳細については、「 PathFind ファイル名」を参照してください。For more information, see PathFindFileName.

Cパス::ゲットドライブナンバーCPathT::GetDriveNumber

'A' から 'Z' の範囲内のドライブ文字のパスを検索し、対応するドライブ番号を返します。Call this method to search the path for a drive letter within the range of 'A' to 'Z' and return the corresponding drive number.

int GetDriveNumber() const;

戻り値Return Value

パスにドライブ文字がある場合は、0 から 25 までの整数 ('A から 'Z' に対応) を返します。Returns the drive number as an integer from 0 through 25 (corresponding to 'A' through 'Z') if the path has a drive letter, or -1 otherwise.

解説Remarks

詳細については、「パスGetドライブ番号」を参照してください。For more information, see PathGetDriveNumber.

CPathT::拡張機能を取得します。CPathT::GetExtension

パスからファイル拡張子を取得します。Call this method to get the file extension from the path.

StringType GetExtension() const;

戻り値Return Value

ファイル拡張子を返します。Returns the file extension.

Cパス::イズディレクトリCPathT::IsDirectory

パスが有効なディレクトリかどうかを確認します。Call this method to check whether the path is a valid directory.

BOOL IsDirectory() const;

戻り値Return Value

パスがディレクトリの場合は 0 以外の値 (16) を返します。Returns a non-zero value (16) if the path is a directory, FALSE otherwise.

解説Remarks

詳細については、「 PathIsDirectory」を参照してください。For more information, see PathIsDirectory.

CPathT::ファイルスペックCPathT::IsFileSpec

パス区切り文字 (':' や ' '\など) を検索します。Call this method to search a path for any path-delimiting characters (for example, ':' or '\' ). パス区切り文字が存在しない場合、パスはファイル仕様パスと見なされます。If there are no path-delimiting characters present, the path is considered to be a File Spec path.

BOOL IsFileSpec() const;

戻り値Return Value

パス内にパス区切り文字がない場合は TRUE を返し、パス区切り文字がある場合は FALSE を返します。Returns TRUE if there are no path-delimiting characters within the path, or FALSE if there are path-delimiting characters.

解説Remarks

詳細については、「パスIsFileSpec」を参照してください。For more information, see PathIsFileSpec.

Cパス::IsプレフィックスCPathT::IsPrefix

パスに、pszPrefixによって渡される型の有効なプレフィックスが含まれているかどうかを調べます。Call this method to determine whether a path contains a valid prefix of the type passed by pszPrefix.

BOOL IsPrefix(PCXSTR pszPrefix) const;

パラメーターParameters

プレフィックスpszPrefix
検索対象のプレフィックス。The prefix for which to search. 接頭辞は次のタイプの 1\\つです。\\".A prefix is one of these types: "C:\\", ".", "..", "..\\".

戻り値Return Value

パスにプレフィックスが含まれている場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the path contains the prefix, or FALSE otherwise.

解説Remarks

詳細については、「 PathIsPrefix」を参照してください。For more information, see PathIsPrefix.

Cパス::イズ相対CPathT::IsRelative

パスが相対パスかどうかを調べます。Call this method to determine if the path is relative.

BOOL IsRelative() const;

戻り値Return Value

パスが相対パスの場合は TRUE を返し、絶対パスの場合は FALSE を返します。Returns TRUE if the path is relative, or FALSE if it is absolute.

解説Remarks

詳細については、「 PathIsRelative」を参照してください。For more information, see PathIsRelative.

CPathT::イズルートCPathT::IsRoot

パスがディレクトリ ルートかどうかを調べます。Call this method to determine if the path is a directory root.

BOOL IsRoot() const;

戻り値Return Value

パスがルートの場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the path is a root, or FALSE otherwise.

解説Remarks

詳細については、「 PathIsRoot」を参照してください。For more information, see PathIsRoot.

CPathT::イササミルートCPathT::IsSameRoot

現在のパスを持つ共通のルート コンポーネントが別のパスにあるかどうかを調べます。Call this method to determine whether another path has a common root component with the current path.

BOOL IsSameRoot(PCXSTR pszOther) const;

パラメーターParameters

その他pszOther
もう一方のパス。The other path.

戻り値Return Value

両方の文字列が同じルート コンポーネントを持つ場合は TRUE を返し、そうでない場合は FALSE を返します。Returns TRUE if both strings have the same root component, or FALSE otherwise.

解説Remarks

詳細については、「 PathIsSameRoot」を参照してください。For more information, see PathIsSameRoot.

CPathT::IsUNCCPathT::IsUNC

パスがサーバーと共有の有効な UNC (汎用名前付け規則) パスであるかどうかを確認します。Call this method to determine whether the path is a valid UNC (universal naming convention) path for a server and share.

BOOL IsUNC() const;

戻り値Return Value

パスが有効な UNC パスの場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the path is a valid UNC path, or FALSE otherwise.

解説Remarks

詳細については、「 PathIsUNC」を参照してください。For more information, see PathIsUNC.

Cパス::サーバーCPathT::IsUNCServer

パスがサーバーのみの有効な UNC (汎用名前付け規則) パスであるかどうかを確認します。Call this method to determine whether the path is a valid UNC (universal naming convention) path for a server only.

BOOL IsUNCServer() const;

戻り値Return Value

文字列がサーバーのみの有効な UNC パス (共有名なし) の場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the string is a valid UNC path for a server only (no share name), or FALSE otherwise.

解説Remarks

詳細については、「パスIsUNCサーバー」を参照してください。For more information, see PathIsUNCServer.

Cパス::サーバーシェアCPathT::IsUNCServerShare

パスが有効な UNC \ \ (汎用名前付け規則) 共有パスである\ サーバー共有かどうかを確認します。Call this method to determine whether the path is a valid UNC (universal naming convention) share path, \\ server\ share.

BOOL IsUNCServerShare() const;

戻り値Return Value

パスが\\ フォーム サーバー\ 共有にある場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the path is in the form \\ server\ share, or FALSE otherwise.

解説Remarks

詳細については、「サーバーの共有」を参照してください。For more information, see PathIsUNCServerShare.

CPathT::m_strPathCPathT::m_strPath

パス。The path.

StringType m_strPath;

解説Remarks

StringTypeは テンプレート パラメータCPathTです。StringType is the template parameter to CPathT.

Cパス::メイクプリティCPathT::MakePretty

パスをすべての小文字に変換して、パスの外観に一貫性を持たせる場合に、このメソッドを呼び出します。Call this method to convert a path to all lowercase characters to give the path a consistent appearance.

BOOL MakePretty();

戻り値Return Value

パスが変換されている場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the path has been converted, or FALSE otherwise.

解説Remarks

詳細については、「パスメイクプリティ」を参照してください。For more information, see PathMakePretty.

Cパス:マッチスペックCPathT::MatchSpec

ワイルドカード一致の種類を含む文字列のパスを検索します。Call this method to search the path for a string containing a wildcard match type.

BOOL MatchSpec(PCXSTR pszSpec) const;

パラメーターParameters

を指定します。pszSpec
検索対象のファイルの種類を持つ null で終わる文字列へのポインター。Pointer to a null-terminated string with the file type for which to search. たとえば、現在のパスにあるファイルが DOC ファイルかどうかをテストするには 、pszSpecを "*.doc" に設定する必要があります。For example, to test whether the file at the current path is a DOC file, pszSpec should be set to "*.doc".

戻り値Return Value

文字列が一致する場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if the string matches, or FALSE otherwise.

解説Remarks

詳細については、「パスマッチ仕様」を参照してください。For more information, see PathMatchSpec.

CPathT::演算子 +=CPathT::operator +=

この演算子は、パスに文字列を追加します。This operator appends a string to the path.

CPathT<StringType>& operator+=(PCXSTR pszMore);

パラメーターParameters

pszもっとpszMore
追加する文字列。The string to append.

戻り値Return Value

更新されたパスを返します。Returns the updated path.

CPathT::演算子定数文字列型&CPathT::operator const StringType &

この演算子を使用すると、オブジェクトを文字列として扱うことができます。This operator allows the object to be treated like a string.

operator const StringType&() const throw();

戻り値Return Value

このオブジェクトが管理する現在のパスを表す文字列を返します。Returns a string representing the current path managed by this object.

CPathT::オペレーター CPathT::PCXSTRCPathT::operator CPathT::PCXSTR

この演算子を使用すると、オブジェクトを文字列として扱うことができます。This operator allows the object to be treated like a string.

operator PCXSTR() const throw();

戻り値Return Value

このオブジェクトが管理する現在のパスを表す文字列を返します。Returns a string representing the current path managed by this object.

CPathT::演算子文字列型&CPathT::operator StringType &

この演算子を使用すると、オブジェクトを文字列として扱うことができます。This operator allows the object to be treated like a string.

operator StringType&() throw();

戻り値Return Value

このオブジェクトが管理する現在のパスを表す文字列を返します。Returns a string representing the current path managed by this object.

次のサービスを:PCPathT::PCXSTR

定数文字列型。A constant string type.

typedef StringType::PCXSTR PCXSTR;

解説Remarks

StringTypeは テンプレート パラメータCPathTです。StringType is the template parameter to CPathT.

:PXSTRCPathT::PXSTR

文字列型。A string type.

typedef StringType::PXSTR PXSTR;

解説Remarks

StringTypeは テンプレート パラメータCPathTです。StringType is the template parameter to CPathT.

CPathT::引用スペースCPathT::QuoteSpaces

パスにスペースが含まれている場合は、このメソッドを呼び出して、パスを引用符で囲みます。Call this method to enclose the path in quotation marks if it contains any spaces.

void QuoteSpaces();

解説Remarks

詳細については、「パスクオートスペース」を参照してください。For more information, see PathQuoteSpaces.

Cパス::相対パスCPathT::RelativePathTo

あるファイルまたはフォルダーから別のファイルまたはフォルダーへの相対パスを作成します。Call this method to create a relative path from one file or folder to another.

BOOL RelativePathTo(
    PCXSTR pszFrom,
    DWORD dwAttrFrom,
    PCXSTR pszTo,
    DWORD dwAttrTo);

パラメーターParameters

を起pszFrom
相対パスの始点。The start of the relative path.

ドワトトルフロdwAttrFrom
pszFromのファイル属性。The File attributes of pszFrom. この値にFILE_ATTRIBUTE_DIRECTORYが含まれている場合 、pszFromはディレクトリであると見なされます。それ以外の場合 、pszFromはファイルであると見なされます。If this value contains FILE_ATTRIBUTE_DIRECTORY, pszFrom is assumed to be a directory; otherwise, pszFrom is assumed to be a file.

pszTopszTo
相対パスの終点。The end point of the relative path.

ドワトルトdwAttrTo
pszToのファイル属性。The File attributes of pszTo. この値にFILE_ATTRIBUTE_DIRECTORYが含まれている場合 、pszToはディレクトリであると見なされます。それ以外の場合 、pszToはファイルであると見なされます。If this value contains FILE_ATTRIBUTE_DIRECTORY, pszTo is assumed to be a directory; otherwise, pszTo is assumed to be a file.

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パス相対パス」を参照してください。For more information, see PathRelativePathTo.

CPathT::削除引数CPathT::RemoveArgs

パスからコマンド ライン引数を削除します。Call this method to remove any command-line arguments from the path.

void RemoveArgs();

解説Remarks

詳細については、「パス削除引数 」を参照してください。For more information, see PathRemoveArgs.

CPathT::削除バックスラッシュCPathT::RemoveBackslash

パスから末尾の円記号を削除します。Call this method to remove the trailing backslash from the path.

void RemoveBackslash();

解説Remarks

詳細については、「パス削除バックスラッシュ」を参照してください。For more information, see PathRemoveBackslash.

CPathT::ブランクの削除CPathT::RemoveBlanks

パスから先頭と末尾の空白をすべて削除します。Call this method to remove all leading and trailing spaces from the path.

void RemoveBlanks();

解説Remarks

詳細については、「パス削除空白」を参照してください。For more information, see PathRemoveBlanks.

CPathT::拡張機能の削除CPathT::RemoveExtension

パスからファイル拡張子を削除します (存在する場合)。Call this method to remove the file extension from the path, if there is one.

void RemoveExtension();

解説Remarks

詳細については、「パスの削除拡張」を参照してください。For more information, see PathRemoveExtension.

ファイルの削除CPathT::RemoveFileSpec

パスに末尾のファイル名と円記号がある場合は、このメソッドを呼び出します。Call this method to remove the trailing file name and backslash from the path, if it has them.

BOOL RemoveFileSpec();

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パスの削除ファイルの種類」を参照してください。For more information, see PathRemoveFileSpec.

CPathT::拡張機能の名前の変更CPathT::RenameExtension

パス内のファイル名拡張子を新しい拡張子で置き換えます。Call this method to replace the file name extension in the path with a new extension. ファイル名に拡張子が含まれていない場合、拡張子はパスの末尾に付加されます。If the file name does not contain an extension, the extension will be attached to the end of the path.

BOOL RenameExtension(PCXSTR pszExtension);

パラメーターParameters

拡張pszExtension
新しいファイル名拡張子 (その前に "." 文字が付きます)。The new file name extension, preceded by a "." character.

戻り値Return Value

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。Returns TRUE on success, FALSE on failure.

解説Remarks

詳細については、「パスの名前変更拡張機能」を参照してください。For more information, see PathRenameExtension.

CPathT::スキップルートCPathT::SkipRoot

ドライブ文字または UNC (汎用名前付け規則) サーバー/共有パス部分を無視してパスを解析します。Call this method to parse a path, ignoring the drive letter or UNC (universal naming convention) server/share path parts.

int SkipRoot() const;

戻り値Return Value

ルート (ドライブ文字または UNC サーバー/共有) に続くサブパスの先頭の位置を返します。Returns the position of the beginning of the subpath that follows the root (drive letter or UNC server/share).

解説Remarks

詳細については、「パススキップルート」を参照してください。For more information, see PathSkipRoot.

Cパス::ストリップパスCPathT::StripPath

完全修飾パスとファイル名のパス部分を削除します。Call this method to remove the path portion of a fully qualified path and file name.

void StripPath();

解説Remarks

詳細については、「パスストリップパス」を参照してください。For more information, see PathStripPath.

CPathT::ストリップトルートCPathT::StripToRoot

ルート情報を除くパスのすべての部分を削除します。Call this method to remove all parts of the path except for the root information.

BOOL StripToRoot();

戻り値Return Value

パス内に有効なドライブ文字が見つかった場合は TRUE を返し、それ以外の場合は FALSE を返します。Returns TRUE if a valid drive letter was found in the path, or FALSE otherwise.

解説Remarks

詳細については、「 PathStripToRoot」を参照してください。For more information, see PathStripToRoot.

CPathT::クォートなしスペースCPathT::UnquoteSpaces

パスの先頭と末尾から引用符を削除します。Call this method to remove quotation marks from the beginning and end of a path.

void UnquoteSpaces();

解説Remarks

詳細については、「パスアンクォートスペース」を参照してください。For more information, see PathUnquoteSpaces.

CPathT::XCHARCPathT::XCHAR

文字型。A character type.

typedef StringType::XCHAR XCHAR;

解説Remarks

StringTypeは テンプレート パラメータCPathTです。StringType is the template parameter to CPathT.

関連項目See also

クラスClasses
CStringT クラスCStringT Class