Object to path
Object to path ( pathObject ) : Text
| 引数 | 型 | 説明 | |
|---|---|---|---|
| pathObject | Object | → | パスの中身を定義するオブジェクト |
| 戻り値 | Text | ← | パス名 |
説明
Object to path コマンドはpathObject 引数に渡したパス情報をもとにしたパス名(文字列)を返します。以下のパスがサポートされます:
- システムパス(Windows あるいはmacOS)あるいはPosix パス。パスのタイプはparentFolder プロパティの最後の文字によって定義されます(詳細後述)。
- 相対パスあるいは絶対パス(詳細は絶対 / 相対パス名を参照してください)。
pathObject 引数には、生成したいパスを定義するオブジェクトを渡します。渡すオブジェクトには以下のプロパティが含まれて居る必要があります:
| プロパティ | 型 | 詳細 |
|---|---|---|
| parentFolder | テキスト | パスのディレクトリ情報。最後の文字はフォルダセパレータである必要があります。コマンドはこの文字を使用してパスのタイプを判別しています。最後の文字がPosixセパレータ("/")である場合、パスはPosixシンタックスで作成されます。それ以外の場合にはシステムシンタックスが使用されます。 |
| name | テキスト | 拡張子を含まない、指定されたパスの最後のファイル名あるいはフォルダ名 |
| extension | テキスト | 最後のファイル名あるいはフォルダ名の拡張子。"."で始まります(省略可能)。拡張子をつけない場合には" "(空の文字列)を渡します。 |
| isFolder | ブール | 名前がフォルダ名である場合にはTrue、それ以外の場合にはFalse(デフォルトはFalse です) |
通常、pathObject はPath to object コマンドによって生成されますが、オブジェクトはどのような手段を用いて作成しても構いません。Object to path コマンドは文字列を受け取るだけだという点に注意してください。パスが指定されたパスタイプに対して有効であるかをチェックすることはしませんし、指定されたファイルあるいはフォルダが実際に存在するかどうかもチェックはしません。
例題
ファイルを同じフォルダ内に複製して名前を変更したい場合を考えます:
var $o : Object
$o:=New object
var $path : Text
$path:="C:\\MyDocs\\file.txt"
$o:=Path to object($path)
$o.name:=$o.name+"_copy"
COPY DOCUMENT($path;Object to path($o))
参照
Convert path POSIX to system
Convert path system to POSIX
File
Folder
Path to object
Test path name
プロパティ
| コマンド番号 | 1548 |
| スレッドセーフである | ✓ |