---
title: "CFURLCreateWithBytes(_:_:_:_:_:)"
framework: corefoundation
role: symbol
role_heading: Function
path: "corefoundation/cfurlcreatewithbytes(_:_:_:_:_:)"
---

# CFURLCreateWithBytes(_:_:_:_:_:)

Creates a CFURL object using a given character bytes.

## Declaration

```swift
func CFURLCreateWithBytes(_ allocator: CFAllocator!, _ URLBytes: UnsafePointer<UInt8>!, _ length: CFIndex, _ encoding: CFStringEncoding, _ baseURL: CFURL!) -> CFURL!
```

## Parameters

- `allocator`: The allocator to use to allocate memory for the new CFURL object. Pass NULL or doc://com.apple.corefoundation/documentation/CoreFoundation/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

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

## Discussion

Discussion The specified string encoding will be used both to interpret URLBytes, and to interpret any percent-escapes within the string. note: This function does not support string encoding which isn’t a superset of ASCII encoding. Both CFURLGetBytes(_:_:_:) and CFURLGetByteRangeForComponent(_:_:_:) require 7-bit ASCII characters to be stored in a single 8-bit byte. The following CFStringEncodings can be used: CFStringBuiltInEncodings.macRoman, CFStringBuiltInEncodings.windowsLatin1, CFStringBuiltInEncodings.isoLatin1, CFStringBuiltInEncodings.nextStepLatin, CFStringBuiltInEncodings.ASCII and CFStringBuiltInEncodings.UTF8.

## See Also

### Creating a CFURL

- [CFURLCopyAbsoluteURL(_:)](corefoundation/cfurlcopyabsoluteurl(_:).md)
- [CFURLCreateAbsoluteURLWithBytes(_:_:_:_:_:_:)](corefoundation/cfurlcreateabsoluteurlwithbytes(_:_:_:_:_:_:).md)
- [CFURLCreateByResolvingBookmarkData(_:_:_:_:_:_:_:)](corefoundation/cfurlcreatebyresolvingbookmarkdata(_:_:_:_:_:_:_:).md)
- [CFURLCreateCopyAppendingPathComponent(_:_:_:_:)](corefoundation/cfurlcreatecopyappendingpathcomponent(_:_:_:_:).md)
- [CFURLCreateCopyAppendingPathExtension(_:_:_:)](corefoundation/cfurlcreatecopyappendingpathextension(_:_:_:).md)
- [CFURLCreateCopyDeletingLastPathComponent(_:_:)](corefoundation/cfurlcreatecopydeletinglastpathcomponent(_:_:).md)
- [CFURLCreateCopyDeletingPathExtension(_:_:)](corefoundation/cfurlcreatecopydeletingpathextension(_:_:).md)
- [CFURLCreateFilePathURL(_:_:_:)](corefoundation/cfurlcreatefilepathurl(_:_:_:).md)
- [CFURLCreateFileReferenceURL(_:_:_:)](corefoundation/cfurlcreatefilereferenceurl(_:_:_:).md)
- [CFURLCreateFromFileSystemRepresentation(_:_:_:_:)](corefoundation/cfurlcreatefromfilesystemrepresentation(_:_:_:_:).md)
- [CFURLCreateFromFileSystemRepresentationRelativeToBase(_:_:_:_:_:)](corefoundation/cfurlcreatefromfilesystemrepresentationrelativetobase(_:_:_:_:_:).md)
- [CFURLCreateFromFSRef(_:_:)](corefoundation/cfurlcreatefromfsref(_:_:).md)
- [CFURLCreateWithFileSystemPath(_:_:_:_:)](corefoundation/cfurlcreatewithfilesystempath(_:_:_:_:).md)
- [CFURLCreateWithFileSystemPathRelativeToBase(_:_:_:_:_:)](corefoundation/cfurlcreatewithfilesystempathrelativetobase(_:_:_:_:_:).md)
- [CFURLCreateWithString(_:_:_:)](corefoundation/cfurlcreatewithstring(_:_:_:).md)