Struct core_foundation::string::CFString

pub struct CFString(_);

An immutable string in one of a variety of encodings.

Methods

impl CFString

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

Creates a new CFString instance from a Rust string.

pub fn from_static_string(string: &'static str) -> CFString

Like CFString::new, but references a string that can be used as a backing store by virtue of being statically allocated.

pub fn char_len(&self) -> CFIndex

Returns the number of characters in the string.

Trait Implementations

impl ConcreteCFType for CFString

impl TCFType for CFString

type Ref = CFStringRef

The reference type wrapped inside this type.

fn as_concrete_TypeRef(&self) -> CFStringRef

Returns the object as its concrete TypeRef.

unsafe fn wrap_under_get_rule(reference: CFStringRef) -> Self

Returns an instance of the object, wrapping the underlying CFTypeRef subclass. Use this when following Core Foundation's "Get Rule". The reference count is bumped.

fn as_CFTypeRef(&self) -> CFTypeRef

Returns the object as a raw CFTypeRef. The reference count is not adjusted.

unsafe fn wrap_under_create_rule(reference: CFStringRef) -> Self

Returns an instance of the object, wrapping the underlying CFTypeRef subclass. Use this when following Core Foundation's "Create Rule". The reference count is not bumped.

fn type_id() -> CFTypeID

Returns the type ID for this class.

fn as_CFType(&self) -> CFType

Returns the object as a wrapped CFType. The reference count is incremented by one.

fn into_CFType(self) -> CFType where
    Self: Sized, 

Returns the object as a wrapped CFType. Consumes self and avoids changing the reference count.

fn retain_count(&self) -> CFIndex

Returns the reference count of the object. It is unwise to do anything other than test whether the return value of this method is greater than zero.

fn type_of(&self) -> CFTypeID

Returns the type ID of this object.

fn show(&self)

Writes a debugging version of this object on standard error.

fn instance_of<OtherCFType: TCFType>(&self) -> bool

Returns true if this value is an instance of another type.

impl<'a> ToVoid<CFString> for &'a CFString

fn to_void(&self) -> *const c_void

impl ToVoid<CFString> for CFString

fn to_void(&self) -> *const c_void

impl ToVoid<CFString> for CFStringRef

fn to_void(&self) -> *const c_void

impl CFPropertyListSubClass for CFString

fn to_CFPropertyList(&self) -> CFPropertyList

Create an instance of the superclass type [CFPropertyList] for this instance.

fn into_CFPropertyList(self) -> CFPropertyList where
    Self: Sized, 

Equal to [to_CFPropertyList], but consumes self and avoids changing the reference count.

impl Drop for CFString

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq<CFString> for CFString

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

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

This method tests for !=.

impl<'a> From<&'a str> for CFString

fn from(string: &'a str) -> CFString

Performs the conversion.

impl<'a> From<&'a CFString> for Cow<'a, str>

fn from(cf_str: &'a CFString) -> Cow<'a, str>

Performs the conversion.

impl Clone for CFString

fn clone(&self) -> CFString

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Eq for CFString

impl Display for CFString

fn fmt(&self, fmt: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Debug for CFString

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl FromStr for CFString

type Err = ()

The associated error which can be returned from parsing.

fn from_str(string: &str) -> Result<CFString, ()>

See also CFString::new for a variant of this which does not return a Result