Struct ascii::AsciiStr [] [src]

pub struct AsciiStr { /* fields omitted */ }

AsciiStr represents a byte or string slice that only contains ASCII characters.

It wraps an [AsciiChar] and implements many of strs methods and traits.

It can be created by a checked conversion from a str or [u8], or borrowed from an AsciiString.

Methods

impl AsciiStr
[src]

Coerces into an AsciiStr slice.

Converts &self to a &str slice.

Converts &self into a byte slice.

Returns the entire string as slice of AsciiChars.

Returns the entire string as mutable slice of AsciiChars.

Returns a raw pointer to the AsciiStr's buffer.

The caller must ensure that the slice outlives the pointer this function returns, or else it will end up pointing to garbage. Modifying the AsciiStr may cause it's buffer to be reallocated, which would also make any pointers to it invalid.

Returns an unsafe mutable pointer to the AsciiStr's buffer.

The caller must ensure that the slice outlives the pointer this function returns, or else it will end up pointing to garbage. Modifying the AsciiStr may cause it's buffer to be reallocated, which would also make any pointers to it invalid.

Copies the content of this AsciiStr into an owned AsciiString.

Converts anything that can represent a byte slice into an AsciiStr.

Examples

let foo = AsciiStr::from_ascii("foo");
let err = AsciiStr::from_ascii("Ŋ");
assert_eq!(foo.unwrap().as_str(), "foo");
assert_eq!(err.unwrap_err().valid_up_to(), 0);Run

Converts anything that can be represented as a byte slice to an AsciiStr without checking for non-ASCII characters..

Examples

let foo = unsafe{ AsciiStr::from_ascii_unchecked("foo") };
assert_eq!(foo.as_str(), "foo");Run

Returns the number of characters / bytes in this ASCII sequence.

Examples

let s = AsciiStr::from_ascii("foo").unwrap();
assert_eq!(s.len(), 3);Run

Returns true if the ASCII slice contains zero bytes.

Examples

let mut empty = AsciiStr::from_ascii("").unwrap();
let mut full = AsciiStr::from_ascii("foo").unwrap();
assert!(empty.is_empty());
assert!(!full.is_empty());Run

Returns an ASCII string slice with leading and trailing whitespace removed.

Examples

let example = AsciiStr::from_ascii("  \twhite \tspace  \t").unwrap();
assert_eq!("white \tspace", example.trim());Run

Returns an ASCII string slice with leading whitespace removed.

Examples

let example = AsciiStr::from_ascii("  \twhite \tspace  \t").unwrap();
assert_eq!("white \tspace  \t", example.trim_left());Run

Returns an ASCII string slice with trailing whitespace removed.

Examples

let example = AsciiStr::from_ascii("  \twhite \tspace  \t").unwrap();
assert_eq!("  \twhite \tspace", example.trim_right());Run

Trait Implementations

impl PartialEq for AsciiStr
[src]

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

This method tests for !=.

impl Eq for AsciiStr
[src]

impl PartialOrd for AsciiStr
[src]

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

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

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

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

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

impl Ord for AsciiStr
[src]

This method returns an Ordering between self and other. Read more

impl Hash for AsciiStr
[src]

Feeds this value into the state given, updating the hasher as necessary.

Feeds a slice of this type into the state provided.

impl PartialEq<str> for AsciiStr
[src]

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

This method tests for !=.

impl ToOwned for AsciiStr
[src]

Creates owned data from borrowed data, usually by cloning. Read more

impl AsRef<[u8]> for AsciiStr
[src]

Performs the conversion.

impl AsRef<str> for AsciiStr
[src]

Performs the conversion.

impl AsRef<[AsciiChar]> for AsciiStr
[src]

Performs the conversion.

impl AsMut<[AsciiChar]> for AsciiStr
[src]

Performs the conversion.

impl Default for &'static AsciiStr
[src]

Returns the "default value" for a type. Read more

impl<'a> From<&'a [AsciiChar]> for &'a AsciiStr
[src]

Performs the conversion.

impl<'a> From<&'a mut [AsciiChar]> for &'a mut AsciiStr
[src]

Performs the conversion.

impl Display for AsciiStr
[src]

Formats the value using the given formatter.

impl Debug for AsciiStr
[src]

Formats the value using the given formatter.

impl Index<usize> for AsciiStr
[src]

The returned type after indexing

The method for the indexing (Foo[Bar]) operation

impl IndexMut<usize> for AsciiStr
[src]

The method for the indexing (Foo[Bar]) operation

impl Index<Range<usize>> for AsciiStr
[src]

The returned type after indexing

The method for the indexing (Foo[Bar]) operation

impl IndexMut<Range<usize>> for AsciiStr
[src]

The method for the indexing (Foo[Bar]) operation

impl Index<RangeTo<usize>> for AsciiStr
[src]

The returned type after indexing

The method for the indexing (Foo[Bar]) operation

impl IndexMut<RangeTo<usize>> for AsciiStr
[src]

The method for the indexing (Foo[Bar]) operation

impl Index<RangeFrom<usize>> for AsciiStr
[src]

The returned type after indexing

The method for the indexing (Foo[Bar]) operation

impl IndexMut<RangeFrom<usize>> for AsciiStr
[src]

The method for the indexing (Foo[Bar]) operation

impl Index<RangeFull> for AsciiStr
[src]

The returned type after indexing

The method for the indexing (Foo[Bar]) operation

impl IndexMut<RangeFull> for AsciiStr
[src]

The method for the indexing (Foo[Bar]) operation

impl AsciiExt for AsciiStr
[src]

Container type for copied ASCII characters.

Checks if the value is within the ASCII range. Read more

Makes a copy of the string in ASCII upper case. Read more

Makes a copy of the string in ASCII lower case. Read more

Checks that two strings are an ASCII case-insensitive match. Read more

Converts this type to its ASCII upper case equivalent in-place. Read more

Converts this type to its ASCII lower case equivalent in-place. Read more

impl AsAsciiStr for AsciiStr
[src]

Convert to an ASCII slice.

Convert to an ASCII slice without checking for non-ASCII characters.

impl AsMutAsciiStr for AsciiStr
[src]

Convert to a mutable ASCII slice.

Convert to a mutable ASCII slice without checking for non-ASCII characters.

impl<'a> PartialEq<String> for &'a AsciiStr
[src]

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

This method tests for !=.

impl<'a> PartialEq<AsciiString> for &'a AsciiStr
[src]

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

This method tests for !=.