Instance Method インスタンスメソッド

getFileSystemRepresentation(_:maxLength:)

Interprets the receiver as a system-independent path and fills a buffer with a C-string in a format and encoding suitable for use with file-system calls. レシーバをシステム独立のパスとして解釈して、ファイルシステム呼び出しで使うのに適したある書式設定と符号化でのC文字列でバッファを満たします。

Declaration 宣言

func getFileSystemRepresentation(_ cname: UnsafeMutablePointer<CChar>, 
                       maxLength max: Int) -> Bool

Parameters パラメータ

buffer: Upon return, contains a C-string that represent the receiver as as a system-independent path, plus the NULL termination byte. The size of buffer must be large enough to contain maxLength bytes. 戻りでは、C文字列を含みます、それはレシーバをシステム独立のパス、加えてNULL終端バイトで表します。bufferの大きさは、maxLengthバイトを含むのに十分な大きさでなければなりません。
maxLength: The maximum number of bytes in the string to return in buffer (including a terminating NULL character, which this method adds). bufferにおいて返す文字列における最大限のバイト数（終端NULL文字を含めて、それはこのメソッドが追加するものです）。

Return Value 戻り値

true if buffer is successfully filled with a file-system representation, otherwise false (for example, if maxLength would be exceeded or if the receiver can’t be represented in the file system’s encoding). true、もしbufferがうまくファイルシステム表現で満たされるならば、そうでなければfalse（例えば、maxLengthが超過されるならば、またはレシーバがファイルシステムの持つ符号化で表現できないならば）。

Discussion 議論

This method operates by replacing the abstract path and extension separator characters (‘/’ and ‘.’ respectively) with their equivalents for the operating system. If the system-specific path or extension separator appears in the abstract representation, the characters it is converted to depend on the system (unless they’re identical to the abstract separators). このメソッドは、抽象的なパスおよび拡張子の分離子の文字それらを（それぞれ ‘/’ および ‘.’ ）オペレーティングシステムのためのそれらの等価物と置き換えることによって演算します。システム特有のパスまたは拡張子の分離子が抽象表現に現れるならば、それら文字はシステムに依存して変換されます（それらが抽象的な分離子と同一である場合を除いて）。

Note that this method only works with file paths (not, for example, string representations of URLs). このメソッドはファイルパスでのみ働くことに注意してください（例えば、URLの文字列表現ではなく）。

The following example illustrates the use of the maxLength argument. The first method invocation returns failure as the file representation of the string (@"/mach_kernel") is 12 bytes long and the value passed as the maxLength argument (12) does not allow for the addition of a NULL termination byte. 以下の例は、maxLength引数の使用を解説します。最初のメソッド発動は、文字列（@"/mach_kernel"）のファイル表現が12バイトの長さであるそしてmaxLength引数として渡される値（12）はNULL終端バイトの追加を想定しないとして、失敗を返します。

char filenameBuffer[13];
BOOL success;
success = [@"/mach_kernel" getFileSystemRepresentation:filenameBuffer maxLength:12];
// success == NO
// Changing the length to include the NULL character does work
success = [@"/mach_kernel" getFileSystemRepresentation:filenameBuffer maxLength:13];
// success == YES

See Also 参照

Working with Paths パスを扱う

class func path(withComponents: [String]) -> String

Returns a string built from the strings in a given array by concatenating them with a path separator between each pair. 各対の間にひとつのパス分離子でそれらを連結することによって、与えられた配列の中の文字列から組み立てられる文字列を返します。

var pathComponents: [String]

The file-system path components of the receiver. レシーバのファイルシステムパス構成要素。

func completePath(into: AutoreleasingUnsafeMutablePointer<NSString?>?, caseSensitive: Bool, matchesInto: AutoreleasingUnsafeMutablePointer<NSArray?>?, filterTypes: [String]?) -> Int

Interprets the receiver as a path in the file system and attempts to perform filename completion, returning a numeric value that indicates whether a match was possible, and by reference the longest path that matches the receiver. レシーバをファイルシステムでのあるパスとして解釈します、そしてファイル名補完を実行しようと試みます、合致が可能であるかどうかを指し示すある数値を、そしてレシーバと合致する最も長いパスを参照によって返します。

var fileSystemRepresentation: UnsafePointer<CChar>

A file system-specific representation of the receiver. あるファイルシステム固有の、レシーバの表現。

var isAbsolutePath: Bool

A Boolean value that indicates whether the receiver represents an absolute path. あるブール値、それはレシーバが絶対パスを表すかどうかを指し示します。

var lastPathComponent: String

The last path component of the receiver. レシーバの最後のパス構成要素。

var pathExtension: String

The path extension, if any, of the string as interpreted as a path. パスとして解釈されるときの文字列のパス拡張子、もしあれば。

var abbreviatingWithTildeInPath: String

A new string that replaces the current home directory portion of the current path with a tilde (~) character. ある新しい文字列、それは現在のパスの現在のホームディレクトリ部分をチルダ（~）文字と置き換えます。

func appendingPathComponent(String) -> String

Returns a new string made by appending to the receiver a given string. ある新しい文字列を返します、レシーバにある与えられた文字列を追加することによって作られます。

func appendingPathExtension(String) -> String?

Returns a new string made by appending to the receiver an extension separator followed by a given extension. ある新しい文字列を返します、レシーバに拡張子の分離子に続けて与えられた拡張子を追加することによって作られます。

var deletingLastPathComponent: String

A new string made by deleting the last path component from the receiver, along with any final path separator. 最後のパス構成要素をあらゆる最後のパス分離子を含めてレシーバから削除することによって作られる新しい文字列。

var deletingPathExtension: String

A new string made by deleting the extension (if any, and only the last) from the receiver. 拡張子を（もしあれば、そして最後のものだけ）レシーバから削除する事によって作られる新しい文字列。

var expandingTildeInPath: String

A new string made by expanding the initial component of the receiver to its full path value. レシーバの冒頭の構成要素をそれの完全パス値に展開する事によって作られる新しい文字列。

var resolvingSymlinksInPath: String

A new string made from the receiver by resolving all symbolic links and standardizing path. 全てのシンボリックリンクを解決することそしてパスを標準化する事によってレシーバから作られる新しい文字列。

var standardizingPath: String

A new string made by removing extraneous path components from the receiver. 本質的でないパス構成要素をレシーバから取り除く事によって作られる新しい文字列。

func strings(byAppendingPaths: [String]) -> [String]

Returns an array of strings made by separately appending to the receiver each string in a given array. 与えられた配列の中の各文字列を個々にレシーバに追加することによって作られる文字列からなる配列を返します。