Function

CFURLCreateFilePathURL

Returns a new file path URL that refers to the same resource as a specified URL.

Declaration

CFURLRef CFURLCreateFilePathURL(CFAllocatorRef allocator, CFURLRef url, CFErrorRef *error);

Parameters

allocator: The allocator to use to allocate memory for the new CFURL object. Pass NULL or kCFAllocatorDefault to use the current default allocator.
url: The URL.
error: The error that occurred if the URL could not be created.

Return Value

The new file path URL, or NULL if an error occurs

Discussion

If the original URL is a file reference URL, this function returns a copy of the URL converted to a file path URL. If the original URL is a file path URL, this function returns the original URL. If the original URL is not a file URL, or if the resource is not reachable or no longer exists, this function returns nil.

See Also

Creating a CFURL

CFURLCopyAbsoluteURL

Creates a new CFURL object by resolving the relative portion of a URL against its base.

CFURLCreateAbsoluteURLWithBytes

Creates a new CFURL object by resolving the relative portion of a URL, specified as bytes, against its given base URL.

CFURLCreateByResolvingBookmarkData

Returns a new URL made by resolving bookmark data.

CFURLCreateCopyAppendingPathComponent

Creates a copy of a given URL and appends a path component.

CFURLCreateCopyAppendingPathExtension

Creates a copy of a given URL and appends a path extension.

CFURLCreateCopyDeletingLastPathComponent

Creates a copy of a given URL with the last path component deleted.

CFURLCreateCopyDeletingPathExtension

Creates a copy of a given URL with its last path extension removed.

CFURLCreateFileReferenceURL

Returns a new file reference URL that points to the same resource as a specified URL.

CFURLCreateFromFileSystemRepresentation

Creates a new CFURL object for a file system entity using the native representation.

CFURLCreateFromFileSystemRepresentationRelativeToBase

Creates a CFURL object from a native character string path relative to a base URL.

CFURLCreateFromFSRef

Creates a URL from a given directory or file.

Deprecated

CFURLCreateWithBytes

Creates a CFURL object using a given character bytes.

CFURLCreateWithFileSystemPath

Creates a CFURL object using a local file system path string.

CFURLCreateWithFileSystemPathRelativeToBase

Creates a CFURL object using a local file system path string relative to a base URL.

CFURLCreateWithString

Creates a CFURL object using a given CFString object.