Struct cannyls::lump::LumpData [−][src]
pub struct LumpData(_);
Lumpのデータ.
最大でMAX_SIZE
までのバイト列を保持可能.
Methods
impl LumpData
[src]
impl LumpData
pub const MAX_SIZE: usize
MAX_SIZE: usize = 65535 * <BlockSize>::MIN as usize - 2
データの最大長(バイト単位).
最小ブロックサイズを用いた場合に表現可能な最大サイズまでのデータが保持可能.
最後の-2
は、内部的に付与されるメタ情報のサイズ分.
蛇足
現状は簡単のために、最小のブロックサイズに合わせた最大サイズ、となっている。
ただし、仕組み上は、ストレージが採用したブロックサイズがそれよりも大きい場合には、 保存可能なデータサイズを比例して大きくすることは可能.
一つ一つのlumpのサイズをあまり巨大にしてしまうと、 一つのlumpの読み書き処理が全体のレイテンシを阻害してしまう可能性もあるので、 現状くらいの制限でちょうど良いのではないかとも思うが、 もし最大サイズをどうしても上げたい場合には、それも不可能ではない、 ということは記しておく.
pub const MAX_EMBEDDED_SIZE: usize
MAX_EMBEDDED_SIZE: usize = 65535
ジャーナル領域に埋め込み可能なデータの最大長(バイト単位).
pub fn new(data: Vec<u8>) -> Result<Self>
[src]
pub fn new(data: Vec<u8>) -> Result<Self>
引数で指定されたデータを保持するLumpData
インスタンスを生成する.
性能上の注意
この関数で生成されたLumpData
インスタンスは、保存先ストレージのブロック境界に合わせた
アライメントが行われていないため、PUTによる保存時に必ず一度、
アライメント用にデータサイズ分のメモリコピーが発生してしまう.
保存時のコピーを避けたい場合にはStorage
ないしDeviceHandle
が提供している
allocate_lump_data_with_bytes
メソッドを使用して、
アライメント済みのLumpData
インスタンスを生成すると良い.
Errors
データのサイズがMAX_SIZE
を超えている場合は、ErrorKind::InvalidInput
エラーが返される.
pub fn new_embedded(data: Vec<u8>) -> Result<Self>
[src]
pub fn new_embedded(data: Vec<u8>) -> Result<Self>
ジャーナル領域埋め込み用のLumpData
インスタンスを生成する.
Errors
data
の長さがMAX_EMBEDDED_SIZE
を超えている場合は、ErrorKind::InvalidInput
エラーが返される.
pub fn as_bytes(&self) -> &[u8]
[src]
pub fn as_bytes(&self) -> &[u8]
データを表すバイト列への参照を返す.
pub fn as_bytes_mut(&mut self) -> &mut [u8]
[src]
pub fn as_bytes_mut(&mut self) -> &mut [u8]
データを表すバイト列への破壊的な参照を返す.
pub fn into_bytes(self) -> Vec<u8>
[src]
pub fn into_bytes(self) -> Vec<u8>
所有権を放棄して、内部のバイト列を返す.
なお、このインスタンスが確保しているのがアライメントされたメモリ領域の場合には、
それを通常のVec<u8>
に変換するためのメモリコピーが、本メソッド呼び出し時に発生することになる.
Trait Implementations
impl Clone for LumpData
[src]
impl Clone for LumpData
fn clone(&self) -> LumpData
[src]
fn clone(&self) -> LumpData
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl AsRef<[u8]> for LumpData
[src]
impl AsRef<[u8]> for LumpData
impl AsMut<[u8]> for LumpData
[src]
impl AsMut<[u8]> for LumpData
impl Debug for LumpData
[src]
impl Debug for LumpData
fn fmt(&self, f: &mut Formatter) -> Result
[src]
fn fmt(&self, f: &mut Formatter) -> Result
Formats the value using the given formatter. Read more
impl PartialEq for LumpData
[src]
impl PartialEq for LumpData
fn eq(&self, other: &Self) -> bool
[src]
fn eq(&self, other: &Self) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
fn ne(&self, other: &Rhs) -> bool
This method tests for !=
.
impl Eq for LumpData
[src]
impl Eq for LumpData