Module malachite_base::vecs::random

Expand description

Iterators that generate Vecs randomly.

random_vecs_length_2

use itertools::Itertools;
use malachite_base::chars::random::random_char_inclusive_range;
use malachite_base::random::EXAMPLE_SEED;
use malachite_base::vecs::random::random_vecs_length_2;

let xss = random_vecs_length_2(
    EXAMPLE_SEED,
    &|seed| random_char_inclusive_range(seed, 'a', 'c'),
    &|seed| random_char_inclusive_range(seed, 'x', 'z'),
)
.take(20)
.collect_vec();
assert_eq!(
    xss.iter().map(Vec::as_slice).collect_vec().as_slice(),
    &[
        &['b', 'z'],
        &['b', 'x'],
        &['b', 'z'],
        &['b', 'y'],
        &['c', 'x'],
        &['a', 'z'],
        &['a', 'z'],
        &['a', 'z'],
        &['c', 'z'],
        &['a', 'y'],
        &['c', 'x'],
        &['a', 'x'],
        &['c', 'z'],
        &['a', 'z'],
        &['c', 'x'],
        &['c', 'x'],
        &['c', 'y'],
        &['b', 'y'],
        &['a', 'x'],
        &['c', 'x']
    ]
);

random_vecs_fixed_length_2_inputs

use itertools::Itertools;
use malachite_base::chars::random::{random_ascii_chars, random_char_inclusive_range};
use malachite_base::random::EXAMPLE_SEED;
use malachite_base::strings::ToDebugString;
use malachite_base::vecs::random::random_vecs_fixed_length_2_inputs;

// We are generating length-3 `Vec`s of `char`s using two input iterators. The first iterator
// (with index 0) produces random ASCII `char`s, and the second (index 1) produces the three
// `char`s `'x'`, `'y'`, and `'z'`, uniformly at random. The elements of `output_types` are 0,
// 1, and 0, meaning that the first element of the output `Vec`s will be taken from iterator 0,
// the second element from iterator 1, and the third also from iterator 0.
let xss = random_vecs_fixed_length_2_inputs(
    EXAMPLE_SEED,
    &random_ascii_chars,
    &|seed| random_char_inclusive_range(seed, 'x', 'z'),
    &[0, 1, 0],
)
.take(20)
.collect_vec();
assert_eq!(
    xss.iter().map(Vec::as_slice).collect_vec().as_slice(),
    &[
        &['U', 'z', '\u{16}'],
        &[' ', 'x', 'D'],
        &['<', 'z', ']'],
        &['a', 'y', 'e'],
        &['_', 'x', 'M'],
        &[',', 'z', 'O'],
        &['\u{1d}', 'z', 'V'],
        &['(', 'z', '\u{10}'],
        &['&', 'z', 'U'],
        &['{', 'y', 'P'],
        &['-', 'x', 'K'],
        &['Z', 'x', '\u{4}'],
        &['X', 'z', '\u{19}'],
        &['_', 'z', ','],
        &['\u{1d}', 'x', ','],
        &['?', 'x', '\''],
        &['[', 'y', 'N'],
        &['|', 'y', '}'],
        &['*', 'x', '\u{15}'],
        &['z', 'x', 't']
    ]
);

This documentation applies not only to RandomFixedLengthVecs2Inputs, but also to RandomFixedLengthVecs3Inputs, RandomFixedLengthVecs4Inputs, and so on. See random_vecs_fixed_length for more information.

RandomFixedLengthVecsFromSingle

Generates random Vecs of a given length using elements from a single iterator.

RandomOrderedUniqueVecs

Generates random Vecs with lengths from an iterator, where the Vecs have no repeated elements, and the elements are in ascending order.

RandomUniqueVecs

Generates random Vecs with lengths from an iterator, where the Vecs have no repeated elements.

RandomVecs

Generates random Vecs using elements from an iterator and with lengths from another iterator.

Enums

RandomOrderedUniqueVecsFixedLength

Generates random Vecs of a fixed length, where the Vecs have no repeated elements, and the elements are in ascending order.

RandomUniqueVecsFixedLength

Generates random Vecs of a fixed length, where the Vecs have no repeated elements.

Functions

random_ordered_unique_vecs

Generates random Vecs using elements from an iterator, where the Vecs have no repeated elements, and the elements are in ascending order.

random_ordered_unique_vecs_fixed_length

Randomly generates Vecs of a given length, where the Vecs have no repeated elements, and the elements are in ascending order.

random_ordered_unique_vecs_from_length_iterator

Generates random Vecs using elements from an iterator and with lengths from another iterator, where the Vecs have no repeated elements, and the elements are in ascending order.

random_ordered_unique_vecs_length_inclusive_range

Generates random Vecs with lengths in $[a, b]$, using elements from an iterator, where the Vecs have no repeated elements, and the elements are in ascending order.

random_ordered_unique_vecs_length_range

Generates random Vecs with lengths in $[a, b)$, using elements from an iterator, where the Vecs have no repeated elements, and the elements are in ascending order.

random_ordered_unique_vecs_min_length

Generates random Vecs with a minimum length, using elements from an iterator, where the Vecs have no repeated elements, and the elements are in ascending order.

random_unique_vecs

Generates random Vecs using elements from an iterator, where the Vecs have no repeated elements.

random_unique_vecs_fixed_length

Randomly generates Vecs of a given length, where the Vecs have no repeated elements.

random_unique_vecs_from_length_iterator

Generates random Vecs using elements from an iterator and with lengths from another iterator, where the Vecs have no repeated elements.

random_unique_vecs_length_inclusive_range

Generates random Vecs with lengths in $[a, b]$, using elements from an iterator, where the Vecs have no repeated elements.

random_unique_vecs_length_range

Generates random Vecs with lengths in $[a, b)$, using elements from an iterator, where the Vecs have no repeated elements.

random_unique_vecs_min_length

Generates random Vecs with a minimum length, using elements from an iterator, where the Vecs have no repeated elements.

random_vecs

Generates random Vecs using elements from an iterator.

random_vecs_fixed_length_2_inputs

This documentation applies not only to random_vecs_fixed_length_2_inputs, but also to random_vecs_fixed_length_3_inputs, random_vecs_fixed_length_4_inputs, and so on. See random_vecs_fixed_length for more information.

random_vecs_fixed_length_from_single

Randomly generates Vecs of a given length using elements from a single iterator.

random_vecs_from_length_iterator

Generates random Vecs using elements from an iterator and with lengths from another iterator.

random_vecs_length_2

This documentation applies not only to random_vecs_length_2, but also to random_vecs_length_3, random_vecs_length_4, and so on. See random_vecs_fixed_length for more information.

random_vecs_length_inclusive_range

Generates random Vecs with lengths in $[a, b]$, using elements from an iterator.

random_vecs_length_range

Generates random Vecs with lengths in $[a, b)$, using elements from an iterator.

random_vecs_min_length

Generates random Vecs with a minimum length, using elements from an iterator.

Module malachite_base::vecs::random

random_vecs_length_2

random_vecs_fixed_length_2_inputs

Structs

Enums

Functions