malachite-nz 0.14.0

The bignum types Natural and Integer, with efficient algorithms partially derived from GMP and FLINT.
Documentation
// Copyright © 2026 Mikhail Hogrefe
//
// This file is part of Malachite.
//
// Malachite is free software: you can redistribute it and/or modify it under the terms of the GNU
// Lesser General Public License (LGPL) as published by the Free Software Foundation; either version
// 3 of the License, or (at your option) any later version. See <https://www.gnu.org/licenses/>.

/// Implementations of traits for converting a
/// [`NaturalVector`](crate::natural_vector::NaturalVector) to an
/// [`IntegerVector`](super::IntegerVector).
pub mod from_iterator;
pub mod from_natural_vector;
/// Implementations of traits for converting an
/// [`UnsignedVector`](malachite_base::unsigned_vector::UnsignedVector) to an
/// [`IntegerVector`](super::IntegerVector).
pub mod from_unsigned_vector;
/// Implementations of traits for converting an [`IntegerVector`](super::IntegerVector) to a
/// [`NaturalVector`](crate::natural_vector::NaturalVector).
///
/// # try_from
/// ```
/// use core::str::FromStr;
/// use malachite_nz::integer_vector::IntegerVector;
/// use malachite_nz::natural_vector::NaturalVector;
///
/// let v = IntegerVector::from_str("(3, 1000000000000000000000000)").unwrap();
/// assert_eq!(
///     NaturalVector::try_from(&v).unwrap().to_string(),
///     "(3, 1000000000000000000000000)"
/// );
/// assert_eq!(
///     NaturalVector::try_from(v).unwrap().to_string(),
///     "(3, 1000000000000000000000000)"
/// );
///
/// let v = IntegerVector::from_str("(3, -1)").unwrap();
/// assert!(NaturalVector::try_from(&v).is_err());
/// assert!(NaturalVector::try_from(v).is_err());
///
/// assert_eq!(
///     NaturalVector::try_from(IntegerVector::from_str("()").unwrap())
///         .unwrap()
///         .to_string(),
///     "()"
/// );
/// ```
///
/// # convertible_from
/// ```
/// use core::str::FromStr;
/// use malachite_base::num::conversion::traits::ConvertibleFrom;
/// use malachite_nz::integer_vector::IntegerVector;
/// use malachite_nz::natural_vector::NaturalVector;
///
/// assert_eq!(
///     NaturalVector::convertible_from(
///         &IntegerVector::from_str("(3, 1000000000000000000000000)").unwrap()
///     ),
///     true
/// );
/// assert_eq!(
///     NaturalVector::convertible_from(&IntegerVector::from_str("(3, -1)").unwrap()),
///     false
/// );
/// assert_eq!(
///     NaturalVector::convertible_from(&IntegerVector::from_str("()").unwrap()),
///     true
/// );
/// ```
pub mod into_iterator;
pub mod natural_vector_from_integer_vector;
/// Functions for converting an [`IntegerVector`](super::IntegerVector) to and from a [`String`].
pub mod string;
/// Implementations of traits for converting an [`IntegerVector`](super::IntegerVector) to an
/// [`UnsignedVector`](malachite_base::unsigned_vector::UnsignedVector).
///
/// # try_from
/// ```
/// use core::str::FromStr;
/// use malachite_base::unsigned_vector::UnsignedVector;
/// use malachite_nz::integer_vector::IntegerVector;
///
/// let v = IntegerVector::from_str("(3, 255)").unwrap();
/// assert_eq!(
///     UnsignedVector::<u8>::try_from(&v).unwrap().to_string(),
///     "(3, 255)"
/// );
/// assert_eq!(
///     UnsignedVector::<u64>::try_from(v).unwrap().to_string(),
///     "(3, 255)"
/// );
///
/// let v = IntegerVector::from_str("(3, 256)").unwrap();
/// assert!(UnsignedVector::<u8>::try_from(&v).is_err());
/// assert_eq!(
///     UnsignedVector::<u16>::try_from(&v).unwrap().to_string(),
///     "(3, 256)"
/// );
///
/// // A negative element never fits.
/// let v = IntegerVector::from_str("(3, -1)").unwrap();
/// assert!(UnsignedVector::<u64>::try_from(&v).is_err());
/// ```
///
/// # convertible_from
/// ```
/// use core::str::FromStr;
/// use malachite_base::num::conversion::traits::ConvertibleFrom;
/// use malachite_base::unsigned_vector::UnsignedVector;
/// use malachite_nz::integer_vector::IntegerVector;
///
/// assert_eq!(
///     UnsignedVector::<u8>::convertible_from(&IntegerVector::from_str("(3, 255)").unwrap()),
///     true
/// );
/// assert_eq!(
///     UnsignedVector::<u8>::convertible_from(&IntegerVector::from_str("(3, 256)").unwrap()),
///     false
/// );
/// assert_eq!(
///     UnsignedVector::<u64>::convertible_from(&IntegerVector::from_str("(3, -1)").unwrap()),
///     false
/// );
/// assert_eq!(
///     UnsignedVector::<u32>::convertible_from(&IntegerVector::from_str("()").unwrap()),
///     true
/// );
/// ```
pub mod unsigned_vector_from_integer_vector;