pub struct StringRegion<R = OwnedRegion<u8>> { /* private fields */ }
Expand description
A region to store strings and read &str
.
Delegates to a region R
to store u8
slices. By default, it uses a OwnedRegion
, but a
different region can be provided, as long as it absorbs and reads items as &[u8]
.
Note that all implementations of Push<T> for StringRegion
must only accept valid utf-8 data
because the region does not validate the contents when indexing.
§Examples
We fill some data into a string region and use extract it later.
use flatcontainer::{RegionPreference, Push, OwnedRegion, Region, StringRegion};
let mut r = <StringRegion>::default();
let panagram_en = "The quick fox jumps over the lazy dog";
let panagram_de = "Zwölf Boxkämpfer jagen Viktor quer über den großen Sylter Deich";
let en_index = r.push(panagram_en);
let de_index = r.push(panagram_de);
assert_eq!(panagram_de, r.index(de_index));
assert_eq!(panagram_en, r.index(en_index));
Trait Implementations§
Source§impl<R> Clone for StringRegion<R>where
R: Clone,
impl<R> Clone for StringRegion<R>where
R: Clone,
Source§fn clone(&self) -> StringRegion<R>
fn clone(&self) -> StringRegion<R>
Returns a copy of the value. Read more
Source§fn clone_from(&mut self, source: &StringRegion<R>)
fn clone_from(&mut self, source: &StringRegion<R>)
Performs copy-assignment from
source
. Read moreSource§impl<R> Debug for StringRegion<R>where
R: Debug,
impl<R> Debug for StringRegion<R>where
R: Debug,
Source§impl<R> Default for StringRegion<R>where
R: Default,
impl<R> Default for StringRegion<R>where
R: Default,
Source§fn default() -> StringRegion<R>
fn default() -> StringRegion<R>
Returns the “default value” for a type. Read more
Source§impl<'de, R> Deserialize<'de> for StringRegion<R>where
R: Deserialize<'de>,
impl<'de, R> Deserialize<'de> for StringRegion<R>where
R: Deserialize<'de>,
Source§fn deserialize<__D>(
__deserializer: __D,
) -> Result<StringRegion<R>, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(
__deserializer: __D,
) -> Result<StringRegion<R>, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
Source§impl<R> Push<&&str> for StringRegion<R>
impl<R> Push<&&str> for StringRegion<R>
Source§impl<R> Push<&String> for StringRegion<R>
impl<R> Push<&String> for StringRegion<R>
Source§impl<R> Push<&str> for StringRegion<R>
impl<R> Push<&str> for StringRegion<R>
Source§impl<R> Push<String> for StringRegion<R>
impl<R> Push<String> for StringRegion<R>
Source§impl<R> Region for StringRegion<R>
impl<R> Region for StringRegion<R>
Source§type ReadItem<'a> = &'a str
where
StringRegion<R>: 'a
type ReadItem<'a> = &'a str where StringRegion<R>: 'a
The type of the data that one gets out of the container.
Source§type Index = <R as Region>::Index
type Index = <R as Region>::Index
The type to index into the container. Should be treated
as an opaque type, even if known.
Source§fn merge_regions<'a>(
regions: impl Iterator<Item = &'a StringRegion<R>> + Clone,
) -> StringRegion<R>where
StringRegion<R>: 'a,
fn merge_regions<'a>(
regions: impl Iterator<Item = &'a StringRegion<R>> + Clone,
) -> StringRegion<R>where
StringRegion<R>: 'a,
Construct a region that can absorb the contents of
regions
in the future.Source§fn index(
&self,
index: <StringRegion<R> as Region>::Index,
) -> <StringRegion<R> as Region>::ReadItem<'_>
fn index( &self, index: <StringRegion<R> as Region>::Index, ) -> <StringRegion<R> as Region>::ReadItem<'_>
Index into the container. The index must be obtained by
pushing data into the container.
Source§fn reserve_regions<'a, I>(&mut self, regions: I)
fn reserve_regions<'a, I>(&mut self, regions: I)
Ensure that the region can absorb the items of
regions
without reallocationSource§fn reborrow<'b, 'a>(
item: <StringRegion<R> as Region>::ReadItem<'a>,
) -> <StringRegion<R> as Region>::ReadItem<'b>where
'a: 'b,
StringRegion<R>: 'a,
fn reborrow<'b, 'a>(
item: <StringRegion<R> as Region>::ReadItem<'a>,
) -> <StringRegion<R> as Region>::ReadItem<'b>where
'a: 'b,
StringRegion<R>: 'a,
Converts a read item into one with a narrower lifetime.
Source§impl<'a, 'b, R> ReserveItems<&'a &'b str> for StringRegion<R>
impl<'a, 'b, R> ReserveItems<&'a &'b str> for StringRegion<R>
Source§impl<'b, R> ReserveItems<&'b String> for StringRegion<R>
impl<'b, R> ReserveItems<&'b String> for StringRegion<R>
Source§impl<'b, R> ReserveItems<&'b str> for StringRegion<R>
impl<'b, R> ReserveItems<&'b str> for StringRegion<R>
Source§impl<R> Serialize for StringRegion<R>where
R: Serialize,
impl<R> Serialize for StringRegion<R>where
R: Serialize,
Source§fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
Serialize this value into the given Serde serializer. Read more
Auto Trait Implementations§
impl<R> Freeze for StringRegion<R>where
R: Freeze,
impl<R> RefUnwindSafe for StringRegion<R>where
R: RefUnwindSafe,
impl<R> Send for StringRegion<R>where
R: Send,
impl<R> Sync for StringRegion<R>where
R: Sync,
impl<R> Unpin for StringRegion<R>where
R: Unpin,
impl<R> UnwindSafe for StringRegion<R>where
R: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
🔬This is a nightly-only experimental API. (
clone_to_uninit
)