Struct fruity__bbqsrc::foundation::NSMutableString

#[repr(C)]
pub struct NSMutableString<'data>(_);

A dynamic plain-text Unicode string object.

See documentation.

Implementations

impl<'data> NSMutableString<'data>

pub fn from_str(s: &str) -> Arc<Self>

Creates a mutable string object from copying a slice.

pub fn from_str_no_copy(s: &'data mut str) -> Arc<Self>

Creates a mutable string object without copying a slice.

Safety

The returned string object or its clones must not outlive the referenced string slice.

Methods from Deref<Target = NSString<'data>>

pub fn copy(&self) -> Arc<Self>

Returns a copy of this object using NSCopying.

See documentation.

pub fn mutable_copy(&self) -> Arc<NSMutableString<'data>>

Returns a copy of this object using NSMutableCopying.

See documentation.

pub fn as_utf8_ptr(&self) -> *const c_char

Returns a null-terminated UTF-8 representation of self, or null if the internal storage of self does not allow this to be returned efficiently.

Unlike to_utf8_ptr, this does not allocate and construct a new UTF-8 C string if self does not represent one.

This is retrieved using CFStringGetCStringPtr and kCFStringEncodingUTF8.

pub fn to_utf8_ptr(&self) -> *const c_char

Returns a null-terminated UTF-8 representation of self.

This C string is a pointer to a structure inside self, which may have a lifetime shorter than the string object and will certainly not have a longer lifetime. Therefore, you should copy the C string if it needs to be stored outside of the memory context in which you use this property.

This is retrieved using -[NSString UTF8String].

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

Returns the contents of self as a native UTF-8 string slice, or None if the internal storage of self does not allow this to be returned efficiently.

Unlike to_str, this does not allocate and construct a new UTF-8 C string if self does not represent one.

Safety

You must ensure that self is not mutated during the lifetime of the returned string slice.

pub unsafe fn to_str(&self) -> &str

Returns the contents of self as a native UTF-8 string slice.

This internally uses to_utf8_ptr. See its documentation for details.

Safety

The lifetime of the returned string slice may be shorter than this object. Therefore, long use cases should copy the bytes of the returned string slice or use to_string.

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

Returns the contents of self as a native UTF-8 string slice ending with a 0 byte, or None if the internal storage of self does not allow this to be returned efficiently.

Unlike to_str_with_nul, this does not allocate and construct a new UTF-8 C string if self does not represent one.

Safety

You must ensure that self is not mutated during the lifetime of the returned string slice.

pub unsafe fn to_str_with_nul(&self) -> &str

Returns the contents of self as a native UTF-8 string slice ending with a 0 byte.

This internally uses to_utf8_ptr. See its documentation for details.

Safety

The lifetime of the returned string slice may be shorter than this object. Therefore, long use cases should copy the bytes of the returned string slice or use to_string_with_nul.

pub fn to_string(&self) -> String

Returns the contents of self as a native UTF-8 string buffer.

This internally uses to_utf8_ptr. See its documentation for details.

Performance Considerations

Because of how -[NSString UTF8String] works, this method will likely allocate twice as much memory needed for the length of the resulting buffer. If your use case is short-lived enough, consider using to_str to save memory and time.

pub fn to_string_with_nul(&self) -> String

Returns the contents of self as a native UTF-8 string buffer ending with a 0 byte.

This internally uses to_utf8_ptr. See its documentation for details.

Performance Considerations

Because of how -[NSString UTF8String] works, this method will likely allocate twice as much memory needed for the length of the resulting buffer. If your use case is short-lived enough, consider using to_str_with_nul to save memory and time.

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

Returns a pointer to the UTF-16 representation of self, or null if the internal storage of self does not allow this to be returned efficiently.

This is retrieved using CFStringGetCharactersPtr

See as_utf8_ptr for the UTF-8 equivalent.

pub unsafe fn as_utf16(&self) -> Option<&[u16]>

Returns the contents of self as a UTF-16 string slice, or None if the internal storage of self does not allow this to be returned efficiently.

See as_str for the UTF-8 equivalent.

Safety

You must ensure that self is not mutated during the lifetime of the returned slice.

pub fn length(&self) -> NSUInteger

Returns the number of UTF-16 code units in self.

See documentation.

pub fn to_selector(&self) -> Option<Sel>

Returns a selector with self as its name.

If self cannot be converted to UTF-8 (this should be only due to insufficient memory), this returns None.

See documentation.

pub fn compare(&self, other: &NSString<'_>) -> NSComparisonResult

Compares the string and a given string using no options.

See documentation.

pub fn localized_compare(&self, other: &NSString<'_>) -> NSComparisonResult

Compares the string and a given string using a localized comparison.

See documentation.

pub fn case_insensitive_compare(
    &self,
    other: &NSString<'_>
) -> NSComparisonResult

Compares the string with a given string using NSCaseInsensitiveSearch.

See documentation.

pub fn localized_case_insensitive_compare(
    &self,
    other: &NSString<'_>
) -> NSComparisonResult

Compares the string with a given string using a case-insensitive, localized, comparison.

See documentation.

pub fn localized_standard_compare(
    &self,
    other: &NSString<'_>
) -> NSComparisonResult

Compares strings as sorted by the Finder.

This method should be used whenever file names or other strings are presented in lists and tables where Finder-like sorting is appropriate. The exact sorting behavior of this method is different under different locales and may be changed in future releases. This method uses the current locale.

See documentation.

pub fn has_prefix(&self, prefix: &NSString<'_>) -> bool

Returns true if the given string matches the beginning characters of self.

See documentation.

pub fn has_suffix(&self, suffix: &NSString<'_>) -> bool

Returns true if the given string matches the ending characters of this string.

See documentation.

Trait Implementations

impl<'data> AsMut<NSMutableString<'data>> for NSMutableString<'data>

fn as_mut(&mut self) -> &mut Self

Performs the conversion.

impl<'data, T> AsMut<T> for NSMutableString<'data> where
    NSString<'data>: AsMut<T>, 

fn as_mut(&mut self) -> &mut T

Performs the conversion.

impl<'data> AsRef<NSMutableString<'data>> for NSMutableString<'data>

fn as_ref(&self) -> &Self

Performs the conversion.

impl<'data, T> AsRef<T> for NSMutableString<'data> where
    NSString<'data>: AsRef<T>, 

fn as_ref(&self) -> &T

Performs the conversion.

impl<'data> ClassType<'data> for NSMutableString<'data>

fn class() -> &'static Class

Returns the Objective-C class that can be used to instantiate a new instance of Self.

impl Debug for NSMutableString<'_>

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

Formats the value using the given formatter.

impl<'data> Deref for NSMutableString<'data>

type Target = NSString<'data>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for NSMutableString<'_>

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

Formats the value using the given formatter.

impl<'data> ObjectType for NSMutableString<'data>

fn retain(obj: &Self) -> Arc<Self>

Increments the object’s retain count and returns a smart pointer that automatically calls release on Drop.

unsafe fn release(obj: NonNull<Self>)

Decrements the object’s retain count.

impl<'data> ObjectType<'data> for NSMutableString<'data>

fn as_objc_object(&self) -> &ObjCObject<'data>

Casts self into a type-erased Objective-C object.

fn class<'s>(&'s self) -> &'s Class where
    'data: 's, 

Returns the class that this object is an instance of.

impl Ord for NSMutableString<'_>

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<&'_ str> for NSMutableString<'_>

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

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

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

This method tests for !=.

impl PartialEq<NSMutableString<'_>> for NSMutableString<'_>

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

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

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

This method tests for !=.

impl PartialEq<NSMutableString<'_>> for NSString<'_>

fn eq(&self, other: &NSMutableString<'_>) -> bool

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

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

This method tests for !=.

impl PartialEq<NSMutableString<'_>> for str

fn eq(&self, other: &NSMutableString<'_>) -> bool

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

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

This method tests for !=.

impl PartialEq<NSMutableString<'_>> for &str

fn eq(&self, other: &NSMutableString<'_>) -> bool

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

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

This method tests for !=.

impl PartialEq<NSString<'_>> for NSMutableString<'_>

fn eq(&self, other: &NSString<'_>) -> bool

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

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

This method tests for !=.

impl PartialEq<str> for NSMutableString<'_>

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

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

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

This method tests for !=.

impl PartialOrd<&'_ str> for NSMutableString<'_>

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<NSMutableString<'_>> for NSMutableString<'_>

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<NSMutableString<'_>> for NSString<'_>

fn partial_cmp(&self, other: &NSMutableString<'_>) -> Option<Ordering>

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<NSMutableString<'_>> for str

fn partial_cmp(&self, other: &NSMutableString<'_>) -> Option<Ordering>

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<NSMutableString<'_>> for &str

fn partial_cmp(&self, other: &NSMutableString<'_>) -> Option<Ordering>

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<NSString<'_>> for NSMutableString<'_>

fn partial_cmp(&self, other: &NSString<'_>) -> Option<Ordering>

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<str> for NSMutableString<'_>

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Eq for NSMutableString<'_>