Struct serde_with::BoolFromInt

source ·
pub struct BoolFromInt<S: Strictness = Strict>(_);
Expand description

Deserialize a boolean from a number

Deserialize a number (of u8) and turn it into a boolean. The adapter supports a Strict and Flexible format. In Strict mode, the number must be 0 or 1. All other values produce an error. In Flexible mode, the number any non-zero value is converted to true.

During serialization only 0 or 1 are ever emitted.

Examples

#[serde_as]
#[derive(Deserialize, Serialize)]
struct Data(#[serde_as(as = "BoolFromInt")] bool);

let data = Data(true);
let j = json!(1);
// Ensure serialization and deserialization produce the expected results
assert_eq!(j, serde_json::to_value(&data).unwrap());
assert_eq!(data, serde_json::from_value(j).unwrap());

// false maps to 0
let data = Data(false);
let j = json!(0);
assert_eq!(j, serde_json::to_value(&data).unwrap());
assert_eq!(data, serde_json::from_value(j).unwrap());
#[serde_as]
#[derive(Deserialize, Serialize)]
struct Flexible(#[serde_as(as = "BoolFromInt<serde_with::formats::Flexible>")] bool);

// Flexible turns any non-zero number into true
let data = Flexible(true);
let j = json!(100);
assert_eq!(data, serde_json::from_value(j).unwrap());

Trait Implementations§

Deserialize this value from the given Serde deserializer.
Deserialize this value from the given Serde deserializer.
Serialize this value into the given Serde serializer.

Auto Trait Implementations§

Blanket Implementations§

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.