mirror of https://git.sr.ht/~stygianentity/bincode
Added documentation for the src/ module. Added warning for missing docs, fixed missing docs in src/de/mod.rs
This commit is contained in:
parent
7b85fc168e
commit
b480d2b3b3
|
|
@ -101,6 +101,9 @@ pub trait Config: InternalConfig {
|
||||||
|
|
||||||
impl<T: InternalConfig> Config for T {}
|
impl<T: InternalConfig> Config for T {}
|
||||||
|
|
||||||
|
/// The default config. By default this will be:
|
||||||
|
/// - Little endian
|
||||||
|
/// - Variable int encoding
|
||||||
#[derive(Copy, Clone)]
|
#[derive(Copy, Clone)]
|
||||||
pub struct Default;
|
pub struct Default;
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,3 +1,5 @@
|
||||||
|
//! Decoder-based structs and traits.
|
||||||
|
|
||||||
use crate::error::DecodeError;
|
use crate::error::DecodeError;
|
||||||
|
|
||||||
mod decoder;
|
mod decoder;
|
||||||
|
|
|
||||||
|
|
@ -40,7 +40,7 @@ pub enum DecodeError {
|
||||||
/// the max index of the enum.
|
/// the max index of the enum.
|
||||||
max: u32,
|
max: u32,
|
||||||
|
|
||||||
// The index of the enum that the decoder encountered
|
/// The index of the enum that the decoder encountered
|
||||||
found: u32,
|
found: u32,
|
||||||
},
|
},
|
||||||
|
|
||||||
|
|
@ -48,8 +48,10 @@ pub enum DecodeError {
|
||||||
Utf8(core::str::Utf8Error),
|
Utf8(core::str::Utf8Error),
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Integer types. Used by [DecodeError]. These types have no purpose other than being shown in errors.
|
||||||
#[non_exhaustive]
|
#[non_exhaustive]
|
||||||
#[derive(Debug)]
|
#[derive(Debug)]
|
||||||
|
#[allow(missing_docs)]
|
||||||
pub enum IntegerType {
|
pub enum IntegerType {
|
||||||
U16,
|
U16,
|
||||||
U32,
|
U32,
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,5 @@
|
||||||
#![no_std]
|
#![no_std]
|
||||||
|
#![warn(missing_docs)]
|
||||||
|
|
||||||
//! Bincode is a crate for encoding and decoding using a tiny binary
|
//! Bincode is a crate for encoding and decoding using a tiny binary
|
||||||
//! serialization strategy. Using it, you can easily go from having
|
//! serialization strategy. Using it, you can easily go from having
|
||||||
|
|
@ -58,10 +59,10 @@ pub fn encode_into_slice<E: enc::Encodeable>(
|
||||||
pub fn encode_into_slice_with_config<E: enc::Encodeable, C: Config>(
|
pub fn encode_into_slice_with_config<E: enc::Encodeable, C: Config>(
|
||||||
val: E,
|
val: E,
|
||||||
dst: &mut [u8],
|
dst: &mut [u8],
|
||||||
_config: C,
|
config: C,
|
||||||
) -> Result<usize, error::EncodeError> {
|
) -> Result<usize, error::EncodeError> {
|
||||||
let writer = enc::write::SliceWriter::new(dst);
|
let writer = enc::write::SliceWriter::new(dst);
|
||||||
let mut encoder = enc::Encoder::<_, C>::new(writer);
|
let mut encoder = enc::Encoder::<_, C>::new(writer, config);
|
||||||
val.encode(&mut encoder)?;
|
val.encode(&mut encoder)?;
|
||||||
Ok(encoder.into_writer().bytes_written())
|
Ok(encoder.into_writer().bytes_written())
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue