絶対 URL または Url への絶対ローカル ファイル パスを表す String を解析します。次のようなさまざまな非オフィシャル URL 形式を受け取り、クリーンアップします。
- "/usr/local/foo.curl"
- "c:\windows\foo.curl"
- "file:c:\windows\foo.curl"
- "file://c:/windows/foo.curl"
- "file:///c|/windows/foo.curl"
relative-url:
このパラメータが null 以外の場合、str にはこのパラメータで指定されるディレクトリと相対名になる値を指定できます。
このパラメータが null の (または指定しない) 場合、相対名であればエラーがスローされます。
relative: このパラメータは Curl 言語のバージョン 2.0 との下位互換性のためだけに維持されており、将来のリリースでは削除される可能性があります。relative-url パラメータを relative.url に指定するのと同じです。relative-url と relative を両方同時に指定した場合、relative パラメータは無視されます。
encode-if-not-absolute?: この
bool キーワードは、
str を
Url に変換する前に
url-encode-filename を使ってエンコードするかどうかを指定します。これは、
str がネイティブのローカル パスの場合、または str が相対パスで
relative-url が
file: Url の場合に、
Url では不正な文字を処理するためです。この既定値は
true です。
注意事項
絶対
Url またはネイティブの絶対ローカル ファイル パスのような
String は
relative-url を無視します。