Enum ArrayFormat 

#[non_exhaustive]
pub enum ArrayFormat {
    Repeat,
    Brackets,
    Indices,
}

How sequences are written.

use std::collections::BTreeMap;
use deser_urlencoded::{ArrayFormat, SerializerConfig};

let value = BTreeMap::from([("a", vec![1, 2])]);
let with = |arrays| {
    SerializerConfig::builder().arrays(arrays).build().to_string(&value).unwrap()
};
assert_eq!(with(ArrayFormat::Repeat), "a=1&a=2");
assert_eq!(with(ArrayFormat::Brackets), "a%5B%5D=1&a%5B%5D=2");
assert_eq!(with(ArrayFormat::Indices), "a%5B0%5D=1&a%5B1%5D=2");

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Repeat

The key is repeated for every element (a=1&a=2).

This is what HTML forms send for <select multiple> and what URLSearchParams produces. The elements have to be atoms.

Brackets

The key is repeated with empty brackets (a[]=1&a[]=2).

The elements have to be atoms.

Indices

The key is repeated with the index of the element (a[0]=1&a[1]=2, with Nesting::Dots a.0=1&a.1=2).

This is the only format that supports sequences of maps and sequences.

Trait Implementations

impl Clone for ArrayFormat

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ArrayFormat

impl Debug for ArrayFormat

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ArrayFormat

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ArrayFormat

impl PartialEq for ArrayFormat

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ArrayFormat