Function

CFURLCreateWithBytes

Creates a CFURL object using a given character bytes.

Declaration

CFURLRef CFURLCreateWithBytes(CFAllocatorRef allocator, const UInt8 *URLBytes, CFIndex length, CFStringEncoding encoding, CFURLRef baseURL);

Parameters

allocator

The allocator to use to allocate memory for the new CFURL object. Pass NULL or kCFAllocatorDefault to use the current default allocator.

URLBytes

The character bytes to convert into a CFURL object.

length

The number of bytes in URLBytes.

encoding

The string encoding of the URLBytes string. This encoding is also used to interpret percent escape sequences.

baseURL

The URL to which URLBytes is relative. Pass NULL if URLBytes contains an absolute URL or if you want to create a relative URL. If URLBytes contains an absolute URL, this parameter is ignored.

Return Value

A new CFURL object. Ownership follows the create rule. See The Create Rule.

Discussion

The specified string encoding will be used both to interpret URLBytes, and to interpret any percent-escapes within the string.

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.

CFURLCreateFilePathURL

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

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