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.

Declaration

- (BOOL)getFileSystemRepresentation:(char *)cname maxLength:(NSUInteger)max;

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.

maxLength

The maximum number of bytes in the string to return in buffer (including a terminating NULL character, which this method adds).

Return Value

YES if buffer is successfully filled with a file-system representation, otherwise NO (for example, if maxLength would be exceeded or if the receiver can’t be represented in the file system’s encoding).

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).

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.

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

+ pathWithComponents:

Returns a string built from the strings in a given array by concatenating them with a path separator between each pair.

pathComponents

The file-system path components of the receiver.

- completePathIntoString:caseSensitive:matchesIntoArray:filterTypes:

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.

fileSystemRepresentation

A file system-specific representation of the receiver.

absolutePath

A Boolean value that indicates whether the receiver represents an absolute path.

lastPathComponent

The last path component of the receiver.

pathExtension

The path extension, if any, of the string as interpreted as a path.

stringByAbbreviatingWithTildeInPath

A new string that replaces the current home directory portion of the current path with a tilde (~) character.

- stringByAppendingPathComponent:

Returns a new string made by appending to the receiver a given string.

- stringByAppendingPathExtension:

Returns a new string made by appending to the receiver an extension separator followed by a given extension.

stringByDeletingLastPathComponent

A new string made by deleting the last path component from the receiver, along with any final path separator.

stringByDeletingPathExtension

A new string made by deleting the extension (if any, and only the last) from the receiver.

stringByExpandingTildeInPath

A new string made by expanding the initial component of the receiver to its full path value.

stringByResolvingSymlinksInPath

A new string made from the receiver by resolving all symbolic links and standardizing path.

stringByStandardizingPath

A new string made by removing extraneous path components from the receiver.

- stringsByAppendingPaths:

Returns an array of strings made by separately appending to the receiver each string in a given array.