Struct CFString 

pub struct CFString { /* private fields */ }

Apple’s documentation

This is toll-free bridged with NSString.

Implementations

impl CFString

pub unsafe fn with_pascal_string( alloc: Option<&CFAllocator>, p_str: *const i8, encoding: u32, ) -> Option<CFRetained<CFString>>

• Immutable string creation functions **

Safety

• alloc might not allow None.
• p_str must be a valid pointer.

pub unsafe fn with_c_string( alloc: Option<&CFAllocator>, c_str: *const i8, encoding: u32, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• c_str must be a valid pointer.

pub unsafe fn with_bytes( alloc: Option<&CFAllocator>, bytes: *const u8, num_bytes: isize, encoding: u32, is_external_representation: bool, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• bytes must be a valid pointer.

pub unsafe fn with_characters( alloc: Option<&CFAllocator>, chars: *const u16, num_chars: isize, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• chars must be a valid pointer.

pub unsafe fn with_pascal_string_no_copy( alloc: Option<&CFAllocator>, p_str: *const i8, encoding: u32, contents_deallocator: Option<&CFAllocator>, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• p_str must be a valid pointer.
• contents_deallocator might not allow None.

pub unsafe fn with_c_string_no_copy( alloc: Option<&CFAllocator>, c_str: *const i8, encoding: u32, contents_deallocator: Option<&CFAllocator>, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• c_str must be a valid pointer.
• contents_deallocator might not allow None.

pub unsafe fn with_bytes_no_copy( alloc: Option<&CFAllocator>, bytes: *const u8, num_bytes: isize, encoding: u32, is_external_representation: bool, contents_deallocator: Option<&CFAllocator>, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• bytes must be a valid pointer.
• contents_deallocator might not allow None.

pub unsafe fn with_characters_no_copy( alloc: Option<&CFAllocator>, chars: *const u16, num_chars: isize, contents_deallocator: Option<&CFAllocator>, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• chars must be a valid pointer.
• contents_deallocator might not allow None.

pub unsafe fn with_substring( alloc: Option<&CFAllocator>, str: Option<&CFString>, range: CFRange, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• str might not allow None.

pub fn new_copy( alloc: Option<&CFAllocator>, the_string: Option<&CFString>, ) -> Option<CFRetained<CFString>>

impl CFString

pub fn length(&self) -> isize

• Basic accessors for the contents **

pub unsafe fn character_at_index(&self, idx: isize) -> u16

pub unsafe fn characters(&self, range: CFRange, buffer: *mut u16)

Safety

buffer must be a valid pointer.

pub unsafe fn pascal_string( &self, buffer: *mut i8, buffer_size: isize, encoding: u32, ) -> bool

Safety

buffer must be a valid pointer.

pub unsafe fn c_string( &self, buffer: *mut i8, buffer_size: isize, encoding: u32, ) -> bool

Safety

buffer must be a valid pointer.

pub fn pascal_string_ptr(&self, encoding: u32) -> *const i8

pub fn c_string_ptr(&self, encoding: u32) -> *const i8

pub fn characters_ptr(&self) -> *const u16

pub unsafe fn bytes( &self, range: CFRange, encoding: u32, loss_byte: u8, is_external_representation: bool, buffer: *mut u8, max_buf_len: isize, used_buf_len: *mut isize, ) -> isize

Safety

• buffer must be a valid pointer.
• used_buf_len must be a valid pointer.

pub fn from_external_representation( alloc: Option<&CFAllocator>, data: Option<&CFData>, encoding: u32, ) -> Option<CFRetained<CFString>>

pub fn new_external_representation( alloc: Option<&CFAllocator>, the_string: Option<&CFString>, encoding: u32, loss_byte: u8, ) -> Option<CFRetained<CFData>>

pub fn smallest_encoding(&self) -> u32

pub fn fastest_encoding(&self) -> u32

pub fn system_encoding() -> u32

pub fn maximum_size_for_encoding(length: isize, encoding: u32) -> isize

pub unsafe fn file_system_representation( &self, buffer: *mut i8, max_buf_len: isize, ) -> bool

• FileSystem path conversion functions **

Safety

buffer must be a valid pointer.

pub fn maximum_size_of_file_system_representation(&self) -> isize

pub unsafe fn with_file_system_representation( alloc: Option<&CFAllocator>, buffer: *const i8, ) -> Option<CFRetained<CFString>>

Safety

• alloc might not allow None.
• buffer must be a valid pointer.

impl CFString

pub unsafe fn compare_with_options_and_locale( &self, the_string2: Option<&CFString>, range_to_compare: CFRange, compare_options: CFStringCompareFlags, locale: Option<&CFLocale>, ) -> CFComparisonResult

Safety

• the_string2 might not allow None.
• locale might not allow None.

pub unsafe fn compare_with_options( &self, the_string2: Option<&CFString>, range_to_compare: CFRange, compare_options: CFStringCompareFlags, ) -> CFComparisonResult

Safety

the_string2 might not allow None.

pub fn compare( &self, the_string2: Option<&CFString>, compare_options: CFStringCompareFlags, ) -> CFComparisonResult

pub unsafe fn find_with_options_and_locale( &self, string_to_find: Option<&CFString>, range_to_search: CFRange, search_options: CFStringCompareFlags, locale: Option<&CFLocale>, result: *mut CFRange, ) -> bool

Safety

• string_to_find might not allow None.
• locale might not allow None.
• result must be a valid pointer.

pub unsafe fn find_with_options( &self, string_to_find: Option<&CFString>, range_to_search: CFRange, search_options: CFStringCompareFlags, result: *mut CFRange, ) -> bool

Safety

• string_to_find might not allow None.
• result must be a valid pointer.

pub unsafe fn new_array_with_find_results( alloc: Option<&CFAllocator>, the_string: Option<&CFString>, string_to_find: Option<&CFString>, range_to_search: CFRange, compare_options: CFStringCompareFlags, ) -> Option<CFRetained<CFArray>>

Safety

• alloc might not allow None.
• the_string might not allow None.
• string_to_find might not allow None.

pub fn find( &self, string_to_find: Option<&CFString>, compare_options: CFStringCompareFlags, ) -> CFRange

pub fn has_prefix(&self, prefix: Option<&CFString>) -> bool

pub fn has_suffix(&self, suffix: Option<&CFString>) -> bool

pub unsafe fn range_of_composed_characters_at_index( &self, the_index: isize, ) -> CFRange

Returns the range of the composed character sequence at the specified index.

Parameter theString: The CFString which is to be searched. If this parameter is not a valid CFString, the behavior is undefined.

Parameter theIndex: The index of the character contained in the composed character sequence. If the index is outside the index space of the string (0 to N-1 inclusive, where N is the length of the string), the behavior is undefined.

Returns: The range of the composed character sequence.

pub unsafe fn find_character_from_set( &self, the_set: Option<&CFCharacterSet>, range_to_search: CFRange, search_options: CFStringCompareFlags, result: *mut CFRange, ) -> bool

Query the range of the first character contained in the specified character set.

Parameter theString: The CFString which is to be searched. If this parameter is not a valid CFString, the behavior is undefined.

Parameter theSet: The CFCharacterSet against which the membership of characters is checked. If this parameter is not a valid CFCharacterSet, the behavior is undefined.

Parameter rangeToSearch: The range of characters within the string to search. If the range location or end point (defined by the location plus length minus 1) are outside the index space of the string (0 to N-1 inclusive, where N is the length of the string), the behavior is undefined. If the range length is negative, the behavior is undefined. The range may be empty (length 0), in which case no search is performed.

Parameter searchOptions: The bitwise-or’ed option flags to control the search behavior. The supported options are kCFCompareBackwards andkCFCompareAnchored. If other option flags are specified, the behavior is undefined.

Parameter result: The pointer to a CFRange supplied by the caller in which the search result is stored. Note that the length of this range can be more than 1, if for instance the result is a composed character. If a pointer to an invalid memory is specified, the behavior is undefined.

Returns: true, if at least a character which is a member of the character set is found and result is filled, otherwise, false.

Safety

• the_set might not allow None.
• result must be a valid pointer.

pub unsafe fn line_bounds( &self, range: CFRange, line_begin_index: *mut isize, line_end_index: *mut isize, contents_end_index: *mut isize, )

Safety

• line_begin_index must be a valid pointer.
• line_end_index must be a valid pointer.
• contents_end_index must be a valid pointer.

pub unsafe fn paragraph_bounds( &self, range: CFRange, par_begin_index: *mut isize, par_end_index: *mut isize, contents_end_index: *mut isize, )

Safety

• par_begin_index must be a valid pointer.
• par_end_index must be a valid pointer.
• contents_end_index must be a valid pointer.

pub unsafe fn hyphenation_location_before_index( &self, location: isize, limit_range: CFRange, options: usize, locale: Option<&CFLocale>, character: *mut u32, ) -> isize

Retrieve the first potential hyphenation location found before the specified location.

Parameter string: The CFString which is to be hyphenated. If this parameter is not a valid CFString, the behavior is undefined.

Parameter location: An index in the string. If a valid hyphen index is returned, it will be before this index.

Parameter limitRange: The range of characters within the string to search. If the range location or end point (defined by the location plus length minus 1) are outside the index space of the string (0 to N-1 inclusive, where N is the length of the string), the behavior is undefined. If the range length is negative, the behavior is undefined. The range may be empty (length 0), in which case no hyphen location is generated.

Parameter options: Reserved for future use.

Parameter locale: Specifies which language’s hyphenation conventions to use. This must be a valid locale. Hyphenation data is not available for all locales. You can use CFStringIsHyphenationAvailableForLocale to test for availability of hyphenation data.

Parameter character: The suggested hyphen character to insert. Pass NULL if you do not need this information.

Returns: an index in the string where it is appropriate to insert a hyphen, if one exists; else kCFNotFound

Safety

• locale might not allow None.
• character must be a valid pointer.

pub fn is_hyphenation_available_for_locale(locale: Option<&CFLocale>) -> bool

pub unsafe fn new_by_combining_strings( alloc: Option<&CFAllocator>, the_array: Option<&CFArray>, separator_string: Option<&CFString>, ) -> Option<CFRetained<CFString>>

• Exploding and joining strings with a separator string **

Safety

• alloc might not allow None.
• the_array generic must be of the correct type.
• the_array might not allow None.
• separator_string might not allow None.

pub fn new_array_by_separating_strings( alloc: Option<&CFAllocator>, the_string: Option<&CFString>, separator_string: Option<&CFString>, ) -> Option<CFRetained<CFArray>>

pub fn int_value(&self) -> i32

• Parsing non-localized numbers from strings **

pub fn double_value(&self) -> f64

impl CFString

pub fn is_encoding_available(encoding: u32) -> bool

• General encoding related functionality **

pub fn list_of_available_encodings() -> *const u32

pub fn name_of_encoding(encoding: u32) -> Option<CFRetained<CFString>>

pub fn convert_encoding_to_ns_string_encoding(encoding: u32) -> u64

pub fn convert_ns_string_encoding_to_encoding(encoding: u64) -> u32

pub fn convert_encoding_to_windows_codepage(encoding: u32) -> u32

pub fn convert_windows_codepage_to_encoding(codepage: u32) -> u32

pub fn convert_iana_char_set_name_to_encoding(&self) -> u32

pub fn convert_encoding_to_iana_char_set_name( encoding: u32, ) -> Option<CFRetained<CFString>>

pub fn most_compatible_mac_string_encoding(encoding: u32) -> u32

impl CFString

pub fn from_str(string: &str) -> CFRetained<CFString>

Creates a new CFString from a str.

pub fn new(string: &str) -> CFRetained<CFString>

👎Deprecated: renamed to CFString::from_str

Alias for easier transition from the core-foundation crate.

pub fn from_static_str(string: &'static str) -> CFRetained<CFString>

Creates a new CFString from a 'static str.

This may be slightly more efficient than CFString::from_str, as it may be able to re-use the existing buffer (since we know it won’t be deallocated).

pub unsafe fn as_str_unchecked(&self) -> Option<&str>

Get the str representation of this string if it can be done efficiently.

Returns None if the internal storage does not allow this to be done efficiently. Use CFString::to_string if performance is not an issue.

Safety

The CFString must not be mutated for the lifetime of the returned string.

Warning: This is very difficult to ensure in generic contexts, e.g. it cannot even be used inside Debug::fmt, since Formatter uses dyn internally, and could thus mutate the string inside there.

Methods from Deref<Target = CFType>

pub fn downcast_ref<T>(&self) -> Option<&T>

where T: ConcreteType,

Attempt to downcast the type to that of type T.

This is the reference-variant. Use CFRetained::downcast if you want to convert a retained type. See also ConcreteType for more details on which types support being converted to.

pub fn retain_count(&self) -> usize

Get the reference count of the object.

This function may be useful for debugging. You normally do not use this function otherwise.

Beware that some things (like CFNumbers, small CFStrings etc.) may not have a normal retain count for optimization purposes, and can return usize::MAX in that case.

Trait Implementations

impl AsRef<AnyObject> for CFString

fn as_ref(&self) -> &AnyObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<CFString> for CFString

fn as_ref(&self) -> &CFString

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<CFString> for NSString

Available on crate feature objc2-core-foundation only.

fn as_ref(&self) -> &CFString

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<CFType> for CFString

fn as_ref(&self) -> &CFType

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<NSString> for CFString

Available on crate feature objc2-core-foundation only.

fn as_ref(&self) -> &NSString

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<AnyObject> for CFString

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<CFType> for CFString

fn borrow(&self) -> &CFType

Immutably borrows from an owned value.

impl ConcreteType for CFString

fn type_id() -> usize

Get the unique CFTypeID identifier for the type.

impl Debug for CFString

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Deref for CFString

type Target = CFType

The resulting type after dereferencing.

fn deref(&self) -> &<CFString as Deref>::Target

Dereferences the value.

impl Display for CFString

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Hash for CFString

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for CFString

fn retain(&self) -> Retained<Self>

where Self: Sized,

Increment the reference count of the receiver.

impl Ord for CFString

fn cmp(&self, other: &CFString) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for CFString

fn eq(&self, other: &CFString) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for CFString

fn partial_cmp(&self, other: &CFString) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl RefEncode for CFString

const ENCODING_REF: Encoding

The Objective-C type-encoding for a reference of this type.

impl Type for CFString

fn retain(&self) -> CFRetained<Self>

where Self: Sized,

Increment the reference count of the receiver.

fn as_concrete_TypeRef(&self) -> &Self

👎Deprecated: this is redundant

Helper for easier transition from the core-foundation crate.

unsafe fn wrap_under_get_rule(ptr: *const Self) -> CFRetained<Self>

where Self: Sized,

👎Deprecated: use CFRetained::retain

Helper for easier transition from the core-foundation crate.

fn as_CFTypeRef(&self) -> &CFType

where Self: AsRef<CFType>,

👎Deprecated: this is redundant (CF types deref to CFType)

Helper for easier transition from the core-foundation crate.

unsafe fn wrap_under_create_rule(ptr: *const Self) -> CFRetained<Self>

where Self: Sized,

👎Deprecated: use CFRetained::from_raw

Helper for easier transition from the core-foundation crate.

impl Eq for CFString