Struct rust_icu_ustring::UChar

pub struct UChar { /* fields omitted */ }

The implementation of the ICU UChar*.

While the original type is defined in umachine.h, most useful functions for manipulating UChar* are in fact here.

The first thing you probably want to do is to start from a UTF-8 rust string, produce a UChar. This is necessarily done with a conversion. See the TryFrom implementations in this crate for that.

Implements UChar* from ICU.

Methods

impl UChar

pub fn new_with_capacity(capacity: usize) -> UChar

Allocates a new UChar with given capacity.

Capacity and size must always be the same with UChar when used for interacting with low-level code.

pub fn make_z(&mut self)

Converts into a zeroed-out string.

This is a very weird ICU API thing, where there apparently exists a zero-terminated UChar*.

pub fn as_c_ptr(&self) -> *const UChar

Returns the constant pointer to the underlying C representation. Intended for use in low-level code.

pub fn len(&self) -> usize

Returns the length of the string, in code points.

pub fn as_mut_c_ptr(&mut self) -> *mut UChar

Returns the underlying representation as a mutable C representation. Caller MUST ensure that the representation won't be reallocated as result of adding anything to it, and that it is correctly sized, or bad things will happen.

pub fn resize(&mut self, new_size: usize)

Resizes this string to match new_size.

If the string is made longer, the new space is filled with zeroes.

Trait Implementations

impl Debug for UChar

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

Formats the value using the given formatter.

impl<'_> TryFrom<&'_ UChar> for String

type Error = Error

The type returned in the event of a conversion error.

fn try_from(u: &UChar) -> Result<String, Self::Error>

Tries to produce a UTF-8 encoded rust string from a UChar.

This conversion ignores warnings and only reports actual ICU errors when they happen.

Implements u_strToUTF8.

impl<'_> TryFrom<&'_ str> for UChar

type Error = Error

The type returned in the event of a conversion error.

fn try_from(rust_string: &str) -> Result<Self, Self::Error>

Tries to produce a string from the UTF-8 encoded thing.

This conversion ignores warnings (e.g. warnings about unterminated buffers), since for rust they are not relevant.

Implements u_strFromUTF8.