Pathクラス
Pathクラスは、ファイルパスを格納したStringインスタンスに対して、さまざまなメソッドを提供します。
クラスの機能
定数
AltDirectorySeparatorChar
Static AltDirectorySeparatorChar As Char
ディレクトリを区切る代替文字を表します。デフォルトで、Asc("/")が指定されています。
DirectorySeparatorChar
Static DirectorySeparatorChar As Char
ディレクトリを区切る文字を表します。デフォルトで、Asc("\")が指定されています。
PathSeparator
Static PathSeparator As Char
特に環境変数でパスを区切る文字を表します。デフォルトで、Asc(";")が指定されています。
VolumeSeparatorChar
Static VolumeSeparatorChar As Char
ボリュームを区切る文字を表します。デフォルトで、Asc(":")が指定されています。
メソッド
GetFileName
指定したパスの、ファイル名の部分だけを取得します。
Static Function GetFileName(path As String) As String
- path
- パスを指定します。
- 戻り値
- pathのファイル名の部分を、Stringインスタンスで返します。
GetFileNameWithoutExtension
指定したパスの、拡張子を除いたファイル名の部分だけを取得します。
Static Function GetFileNameWithoutExtension(path As String) As String
- path
- パスを指定します。
- 戻り値
- pathの拡張子を除いたファイル名の部分を、Stringインスタンスで返します。
GetRandomFileName
ランダムなファイル名を取得します。
Static Function GetRandomFileName() As String
- 戻り値
- ランダムなファイル名を、Stringインスタンスで返します。
まだ厳密に実装されていません。
GetExtension
指定したパスの、拡張子の部分だけを取得します。
Static Function GetExtension(path As String) As String
- path
- パスを指定します。
- 戻り値
- pathの拡張子の部分を、Stringインスタンスで返します。
先頭の"."を含む文字列が返ります。
ChangeExtension
指定したパスの、拡張子を変更します。
Static Function ChangeExtension(path As String, extension As String) As String
- path
- パスを指定します。
- extension
- 先頭の"."を含む、新しい拡張子を指定します。
- 戻り値
- pathの拡張子部分を、extensionで指定した拡張子に変更し、Stringインスタンスで返します。
HasExtension
指定したパスの拡張子があるかどうかを返します。
Static Function HasExtension(ByRef path As String) As Boolean
- path
- パスを指定します。
- 戻り値
- 拡張子がある場合はTrue、それ以外はFalseを返します。
GetTempFileName
一時ファイルを作成し、そのパスを返します。
Static Function GetTempFileName() As String
- 戻り値
- 作成した一時ファイルのパスを、Stringインスタンスで返します。
未実装です。
GetTempPath
システムの一時フォルダのパスを取得します。
Static Function GetTempPath() As String
- 戻り値
- 一時フォルダのパスを、Stringインスタンスで返します。
GetFullPath
指定したパスを、絶対パスにして返します。
Static Function GetFullPath(path As String) As String
- path
- パスを指定します。
- 戻り値
- pathを絶対パスにした、Stringインスタンスを返します。
絶対パスは、GetCurrentDirectory()から得られた情報を元に作成されます。また、すでにpathが絶対パスであった場合、戻り値はpathとなります。
GetDirectoryName
指定したパスの、ひとつ上のディレクトリ(パスが示すファイル,ディレクトリが入っているフォルダ)のパスを取得します。
Static Function GetDirectoryName(path As String) As String
- path
- パスを指定します。
- 戻り値
- pathのひとつ上のフォルダのパスが、Stringインスタンスで返ります。pathがルートディレクトリを示している場合、戻り値はString.Emptyとなります。
GetPathRoot
指定したパスの、ルートディレクトリを取得します。
Static Function GetPathRoot(path As String) As String
- path
- パスを指定します。
- 戻り値
- pathのルートディレクトリが、Stringインスタンスで返ります。pathにルートディレクトリが含まれなかった場合、空の文字列が返ります。
IsPathRooted
指定したパスに、ルートディレクトリが含まれるかどうかを返します。
Static Function IsPathRooted(path As String) As Boolean
- path
- パスを指定します。
- 戻り値
- pathにルートディレクトリが含まれているならTrue、それ以外はFalseです。
Combine
指定した2つのパスを連結させます。
Static Function Combine(path1 As String, path2 As String) As String
- path1
- 先頭のパスを指定します。
- path2
- path1に続く、パスを指定します。
- 戻り値
- path1にpath2を連結させた、Stringインスタンスが返ります。path1の最後が、パス区切り文字"\"で終わっていなかった場合、path1とpath2の間に、"\"を追加します。
備考
Pathクラスは、Windowsファイルパスを想定して作られています。Pathクラスのメソッドを実行する際、パスが正しい値かチェックされ、無効な文字が含まれている場合、IOExceptionが発生します。
