Struct nsstring::nsString

#[repr(C)]
pub struct nsString { /* fields omitted */ }

Methods

impl nsString

pub fn new() -> nsString

Methods from Deref<Target = nsAString>

pub fn assign<T: nsStringLike + ?Sized>(&mut self, other: &T)

Assign the value of other into self, overwriting any value currently stored. Performs an optimized assignment when possible if other is a nsA[C]String.

pub fn fallible_assign<T: nsStringLike + ?Sized>(
    &mut self,
    other: &T
) -> Result<(), ()>

Assign the value of other into self, overwriting any value currently stored. Performs an optimized assignment when possible if other is a nsA[C]String.

Returns Ok(()) on success, and Err(()) if the allocation failed.

pub fn take_from(&mut self, other: &mut nsAString)

Take the value of other and set self, overwriting any value currently stored. The passed-in string will be truncated.

pub fn fallible_take_from(&mut self, other: &mut nsAString) -> Result<(), ()>

Take the value of other and set self, overwriting any value currently stored. If this function fails, the source string will be left untouched, otherwise it will be truncated.

Returns Ok(()) on success, and Err(()) if the allocation failed.

pub fn append<T: nsStringLike + ?Sized>(&mut self, other: &T)

Append the value of other into self.

pub fn fallible_append<T: nsStringLike + ?Sized>(
    &mut self,
    other: &T
) -> Result<(), ()>

Append the value of other into self.

Returns Ok(()) on success, and Err(()) if the allocation failed.

pub unsafe fn set_length(&mut self, len: u32)

Set the length of the string to the passed-in length, and expand the backing capacity to match. This method is unsafe as it can expose uninitialized memory when len is greater than the current length of the string.

pub unsafe fn fallible_set_length(&mut self, len: u32) -> Result<(), ()>

Set the length of the string to the passed-in length, and expand the backing capacity to match. This method is unsafe as it can expose uninitialized memory when len is greater than the current length of the string.

Returns Ok(()) on success, and Err(()) if the allocation failed.

pub fn truncate(&mut self)

pub fn to_mut(&mut self) -> &mut [u16]

Get a &mut reference to the backing data for this string. This method will allocate and copy if the current backing buffer is immutable or shared.

pub fn fallible_to_mut(&mut self) -> Result<&mut [u16], ()>

Get a &mut reference to the backing data for this string. This method will allocate and copy if the current backing buffer is immutable or shared.

Returns Ok(&mut [T]) on success, and Err(()) if the allocation failed.

pub fn assign_utf8<T: nsCStringLike + ?Sized>(&mut self, other: &T)

pub fn fallible_assign_utf8<T: nsCStringLike + ?Sized>(
    &mut self,
    other: &T
) -> Result<(), ()>

pub fn append_utf8<T: nsCStringLike + ?Sized>(&mut self, other: &T)

pub fn fallible_append_utf8<T: nsCStringLike + ?Sized>(
    &mut self,
    other: &T
) -> Result<(), ()>

Trait Implementations

impl PartialEq<nsString> for nsAString

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 Drop for nsString

fn drop(&mut self)

Executes the destructor for this type.

impl Deref for nsString

type Target = nsAString

The resulting type after dereferencing.

fn deref(&self) -> &nsAString

Dereferences the value.

impl DerefMut for nsString

fn deref_mut(&mut self) -> &mut nsAString

Mutably dereferences the value.

impl AsRef<[u16]> for nsString

fn as_ref(&self) -> &[u16]

Performs the conversion.

impl<'a> From<&'a [u16]> for nsString

fn from(s: &'a [u16]) -> nsString

Performs the conversion.

impl<'a> From<&'a Vec<u16>> for nsString

fn from(s: &'a Vec<u16>) -> nsString

Performs the conversion.

impl<'a> From<&'a nsAString> for nsString

fn from(s: &'a nsAString) -> nsString

Performs the conversion.

impl From<Box<[u16]>> for nsString

fn from(s: Box<[u16]>) -> nsString

Performs the conversion.

impl From<Vec<u16>> for nsString

fn from(s: Vec<u16>) -> nsString

Performs the conversion.

impl Write for nsString

fn write_str(&mut self, s: &str) -> Result<(), Error>

Writes a slice of bytes into this writer, returning whether the write succeeded.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a [char] into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments) -> Result<(), Error>

Glue for usage of the [write!] macro with implementors of this trait.

impl Display for nsString

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

Formats the value using the given formatter.

impl Debug for nsString

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

Formats the value using the given formatter.

impl PartialEq for nsString

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<[u16]> for nsString

fn eq(&self, other: &[u16]) -> 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<'a> PartialEq<&'a [u16]> for nsString

fn eq(&self, other: &&'a [u16]) -> 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 nsString

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<'a> PartialEq<&'a str> for nsString

fn eq(&self, other: &&'a 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 nsStringLike for nsString

fn adapt(&self) -> nsStringAdapter

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

fn from(s: &'a str) -> nsString

Performs the conversion.

impl<'a> From<&'a String> for nsString

fn from(s: &'a String) -> nsString

Performs the conversion.