Struct nsstring::nsStr

#[repr(C)]
pub struct nsStr<'a> { /* fields omitted */ }

Methods

impl nsStr<'static>

pub fn new() -> nsStr<'static>

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<'a> PartialEq<nsStr<'a>> for nsAString

fn eq(&self, other: &nsStr<'a>) -> 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> Drop for nsStr<'a>

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> Deref for nsStr<'a>

type Target = nsAString

The resulting type after dereferencing.

fn deref(&self) -> &nsAString

Dereferences the value.

impl<'a> DerefMut for nsStr<'a>

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

Mutably dereferences the value.

impl<'a> AsRef<[u16]> for nsStr<'a>

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

impl<'a> Write for nsStr<'a>

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<'a> Display for nsStr<'a>

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

Formats the value using the given formatter.

impl<'a> Debug for nsStr<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for nsStr<'a>

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

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, 'b> PartialEq<&'b [u16]> for nsStr<'a>

fn eq(&self, other: &&'b [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<str> for nsStr<'a>

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, 'b> PartialEq<&'b str> for nsStr<'a>

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

fn adapt(&self) -> nsStringAdapter