Primitive Type bool

The boolean type.

The bool represents a value, which could only be either true or false. If you cast a bool into an integer, true will be 1 and false will be 0.

Basic usage

bool implements various traits, such as BitAnd, BitOr, Not, etc., which allow us to perform boolean operations using &, | and !.

if always demands a bool value. assert!, being an important macro in testing, checks whether an expression returns true.

let bool_val = true & false | false;
assert!(!bool_val);

Examples

A trivial example of the usage of bool,

let praise_the_borrow_checker = true;

// using the `if` conditional
if praise_the_borrow_checker {
    println!("oh, yeah!");
} else {
    println!("what?!!");
}

// ... or, a match pattern
match praise_the_borrow_checker {
    true => println!("keep praising!"),
    false => println!("you should praise!"),
}

Also, since bool implements the Copy trait, we don't have to worry about the move semantics (just like the integer and float primitives).

Now an example of bool cast to integer type:

assert_eq!(true as i32, 1);
assert_eq!(false as i32, 0);

Trait Implementations

impl BitAnd<m1x32> for bool

type Output = m1x32

The resulting type after applying the & operator.

fn bitand(self, other: m1x32) -> m1x32

Performs the & operation.

impl BitAnd<m64x4> for bool

type Output = m64x4

The resulting type after applying the & operator.

fn bitand(self, other: m64x4) -> m64x4

Performs the & operation.

impl<'a, 'b> BitAnd<&'a bool> for &'b bool

type Output = <bool as BitAnd<bool>>::Output

The resulting type after applying the & operator.

fn bitand(self, other: &'a bool) -> <bool as BitAnd<bool>>::Output

Performs the & operation.

impl BitAnd<m1x8> for bool

type Output = m1x8

The resulting type after applying the & operator.

fn bitand(self, other: m1x8) -> m1x8

Performs the & operation.

impl BitAnd<m16x4> for bool

type Output = m16x4

The resulting type after applying the & operator.

fn bitand(self, other: m16x4) -> m16x4

Performs the & operation.

impl BitAnd<m32x2> for bool

type Output = m32x2

The resulting type after applying the & operator.

fn bitand(self, other: m32x2) -> m32x2

Performs the & operation.

impl BitAnd<m1x64> for bool

type Output = m1x64

The resulting type after applying the & operator.

fn bitand(self, other: m1x64) -> m1x64

Performs the & operation.

impl BitAnd<m16x8> for bool

type Output = m16x8

The resulting type after applying the & operator.

fn bitand(self, other: m16x8) -> m16x8

Performs the & operation.

impl BitAnd<m32x8> for bool

type Output = m32x8

The resulting type after applying the & operator.

fn bitand(self, other: m32x8) -> m32x8

Performs the & operation.

impl BitAnd<bool> for bool

type Output = bool

The resulting type after applying the & operator.

fn bitand(self, rhs: bool) -> bool

Performs the & operation.

impl BitAnd<m8x8> for bool

type Output = m8x8

The resulting type after applying the & operator.

fn bitand(self, other: m8x8) -> m8x8

Performs the & operation.

impl BitAnd<m8x32> for bool

type Output = m8x32

The resulting type after applying the & operator.

fn bitand(self, other: m8x32) -> m8x32

Performs the & operation.

impl BitAnd<m8x2> for bool

type Output = m8x2

The resulting type after applying the & operator.

fn bitand(self, other: m8x2) -> m8x2

Performs the & operation.

impl BitAnd<m16x2> for bool

type Output = m16x2

The resulting type after applying the & operator.

fn bitand(self, other: m16x2) -> m16x2

Performs the & operation.

impl BitAnd<m16x16> for bool

type Output = m16x16

The resulting type after applying the & operator.

fn bitand(self, other: m16x16) -> m16x16

Performs the & operation.

impl BitAnd<m8x16> for bool

type Output = m8x16

The resulting type after applying the & operator.

fn bitand(self, other: m8x16) -> m8x16

Performs the & operation.

impl<'a> BitAnd<bool> for &'a bool

type Output = <bool as BitAnd<bool>>::Output

The resulting type after applying the & operator.

fn bitand(self, other: bool) -> <bool as BitAnd<bool>>::Output

Performs the & operation.

impl BitAnd<m1x16> for bool

type Output = m1x16

The resulting type after applying the & operator.

fn bitand(self, other: m1x16) -> m1x16

Performs the & operation.

impl BitAnd<m8x4> for bool

type Output = m8x4

The resulting type after applying the & operator.

fn bitand(self, other: m8x4) -> m8x4

Performs the & operation.

impl<'a> BitAnd<&'a bool> for bool

type Output = <bool as BitAnd<bool>>::Output

The resulting type after applying the & operator.

fn bitand(self, other: &'a bool) -> <bool as BitAnd<bool>>::Output

Performs the & operation.

impl BitAnd<m64x2> for bool

type Output = m64x2

The resulting type after applying the & operator.

fn bitand(self, other: m64x2) -> m64x2

Performs the & operation.

impl BitAnd<m32x4> for bool

type Output = m32x4

The resulting type after applying the & operator.

fn bitand(self, other: m32x4) -> m32x4

Performs the & operation.

impl FromStr for bool

type Err = ParseBoolError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<bool, ParseBoolError>

Parse a bool from a string.

Yields a Result<bool, ParseBoolError>, because s may or may not actually be parseable.

Examples

use std::str::FromStr;

assert_eq!(FromStr::from_str("true"), Ok(true));
assert_eq!(FromStr::from_str("false"), Ok(false));
assert!(<bool as FromStr>::from_str("not even a boolean").is_err());

Note, in many cases, the .parse() method on str is more proper.

assert_eq!("true".parse(), Ok(true));
assert_eq!("false".parse(), Ok(false));
assert!("not even a boolean".parse::<bool>().is_err());

impl Debug for bool

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

Formats the value using the given formatter.

impl Default for bool

fn default() -> bool

Returns the default value of false

impl<'a> BitXorAssign<&'a bool> for bool

fn bitxor_assign(&mut self, other: &'a bool)

Performs the ^= operation.

impl BitXorAssign<bool> for bool

fn bitxor_assign(&mut self, other: bool)

Performs the ^= operation.

impl<'a> BitOrAssign<&'a bool> for bool

fn bitor_assign(&mut self, other: &'a bool)

Performs the |= operation.

impl BitOrAssign<bool> for bool

fn bitor_assign(&mut self, other: bool)

Performs the |= operation.

impl<'a> BitAndAssign<&'a bool> for bool

fn bitand_assign(&mut self, other: &'a bool)

Performs the &= operation.

impl BitAndAssign<bool> for bool

fn bitand_assign(&mut self, other: bool)

Performs the &= operation.

impl BitOr<bool> for bool

type Output = bool

The resulting type after applying the | operator.

fn bitor(self, rhs: bool) -> bool

Performs the | operation.

impl BitOr<m8x2> for bool

type Output = m8x2

The resulting type after applying the | operator.

fn bitor(self, other: m8x2) -> m8x2

Performs the | operation.

impl BitOr<m8x16> for bool

type Output = m8x16

The resulting type after applying the | operator.

fn bitor(self, other: m8x16) -> m8x16

Performs the | operation.

impl BitOr<m32x2> for bool

type Output = m32x2

The resulting type after applying the | operator.

fn bitor(self, other: m32x2) -> m32x2

Performs the | operation.

impl BitOr<m16x8> for bool

type Output = m16x8

The resulting type after applying the | operator.

fn bitor(self, other: m16x8) -> m16x8

Performs the | operation.

impl BitOr<m8x8> for bool

type Output = m8x8

The resulting type after applying the | operator.

fn bitor(self, other: m8x8) -> m8x8

Performs the | operation.

impl BitOr<m64x2> for bool

type Output = m64x2

The resulting type after applying the | operator.

fn bitor(self, other: m64x2) -> m64x2

Performs the | operation.

impl BitOr<m8x32> for bool

type Output = m8x32

The resulting type after applying the | operator.

fn bitor(self, other: m8x32) -> m8x32

Performs the | operation.

impl BitOr<m32x4> for bool

type Output = m32x4

The resulting type after applying the | operator.

fn bitor(self, other: m32x4) -> m32x4

Performs the | operation.

impl BitOr<m8x4> for bool

type Output = m8x4

The resulting type after applying the | operator.

fn bitor(self, other: m8x4) -> m8x4

Performs the | operation.

impl BitOr<m1x32> for bool

type Output = m1x32

The resulting type after applying the | operator.

fn bitor(self, other: m1x32) -> m1x32

Performs the | operation.

impl BitOr<m16x2> for bool

type Output = m16x2

The resulting type after applying the | operator.

fn bitor(self, other: m16x2) -> m16x2

Performs the | operation.

impl BitOr<m16x4> for bool

type Output = m16x4

The resulting type after applying the | operator.

fn bitor(self, other: m16x4) -> m16x4

Performs the | operation.

impl BitOr<m1x16> for bool

type Output = m1x16

The resulting type after applying the | operator.

fn bitor(self, other: m1x16) -> m1x16

Performs the | operation.

impl<'a> BitOr<bool> for &'a bool

type Output = <bool as BitOr<bool>>::Output

The resulting type after applying the | operator.

fn bitor(self, other: bool) -> <bool as BitOr<bool>>::Output

Performs the | operation.

impl<'a> BitOr<&'a bool> for bool

type Output = <bool as BitOr<bool>>::Output

The resulting type after applying the | operator.

fn bitor(self, other: &'a bool) -> <bool as BitOr<bool>>::Output

Performs the | operation.

impl BitOr<m1x8> for bool

type Output = m1x8

The resulting type after applying the | operator.

fn bitor(self, other: m1x8) -> m1x8

Performs the | operation.

impl BitOr<m32x8> for bool

type Output = m32x8

The resulting type after applying the | operator.

fn bitor(self, other: m32x8) -> m32x8

Performs the | operation.

impl BitOr<m1x64> for bool

type Output = m1x64

The resulting type after applying the | operator.

fn bitor(self, other: m1x64) -> m1x64

Performs the | operation.

impl BitOr<m64x4> for bool

type Output = m64x4

The resulting type after applying the | operator.

fn bitor(self, other: m64x4) -> m64x4

Performs the | operation.

impl BitOr<m16x16> for bool

type Output = m16x16

The resulting type after applying the | operator.

fn bitor(self, other: m16x16) -> m16x16

Performs the | operation.

impl<'a, 'b> BitOr<&'a bool> for &'b bool

type Output = <bool as BitOr<bool>>::Output

The resulting type after applying the | operator.

fn bitor(self, other: &'a bool) -> <bool as BitOr<bool>>::Output

Performs the | operation.

impl Copy for bool

impl Clone for bool

fn clone(&self) -> bool

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialOrd<bool> for bool

fn partial_cmp(&self, other: &bool) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use] fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use] fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use] fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use] fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl BitXor<m16x4> for bool

type Output = m16x4

The resulting type after applying the ^ operator.

fn bitxor(self, other: m16x4) -> m16x4

Performs the ^ operation.

impl BitXor<m8x8> for bool

type Output = m8x8

The resulting type after applying the ^ operator.

fn bitxor(self, other: m8x8) -> m8x8

Performs the ^ operation.

impl BitXor<m32x4> for bool

type Output = m32x4

The resulting type after applying the ^ operator.

fn bitxor(self, other: m32x4) -> m32x4

Performs the ^ operation.

impl BitXor<m1x64> for bool

type Output = m1x64

The resulting type after applying the ^ operator.

fn bitxor(self, other: m1x64) -> m1x64

Performs the ^ operation.

impl<'a> BitXor<bool> for &'a bool

type Output = <bool as BitXor<bool>>::Output

The resulting type after applying the ^ operator.

fn bitxor(self, other: bool) -> <bool as BitXor<bool>>::Output

Performs the ^ operation.

impl BitXor<m8x4> for bool

type Output = m8x4

The resulting type after applying the ^ operator.

fn bitxor(self, other: m8x4) -> m8x4

Performs the ^ operation.

impl BitXor<m1x32> for bool

type Output = m1x32

The resulting type after applying the ^ operator.

fn bitxor(self, other: m1x32) -> m1x32

Performs the ^ operation.

impl BitXor<m1x8> for bool

type Output = m1x8

The resulting type after applying the ^ operator.

fn bitxor(self, other: m1x8) -> m1x8

Performs the ^ operation.

impl BitXor<m8x32> for bool

type Output = m8x32

The resulting type after applying the ^ operator.

fn bitxor(self, other: m8x32) -> m8x32

Performs the ^ operation.

impl BitXor<m32x2> for bool

type Output = m32x2

The resulting type after applying the ^ operator.

fn bitxor(self, other: m32x2) -> m32x2

Performs the ^ operation.

impl BitXor<m64x4> for bool

type Output = m64x4

The resulting type after applying the ^ operator.

fn bitxor(self, other: m64x4) -> m64x4

Performs the ^ operation.

impl<'a> BitXor<&'a bool> for bool

type Output = <bool as BitXor<bool>>::Output

The resulting type after applying the ^ operator.

fn bitxor(self, other: &'a bool) -> <bool as BitXor<bool>>::Output

Performs the ^ operation.

impl BitXor<m8x2> for bool

type Output = m8x2

The resulting type after applying the ^ operator.

fn bitxor(self, other: m8x2) -> m8x2

Performs the ^ operation.

impl BitXor<m1x16> for bool

type Output = m1x16

The resulting type after applying the ^ operator.

fn bitxor(self, other: m1x16) -> m1x16

Performs the ^ operation.

impl<'a, 'b> BitXor<&'a bool> for &'b bool

type Output = <bool as BitXor<bool>>::Output

The resulting type after applying the ^ operator.

fn bitxor(self, other: &'a bool) -> <bool as BitXor<bool>>::Output

Performs the ^ operation.

impl BitXor<m8x16> for bool

type Output = m8x16

The resulting type after applying the ^ operator.

fn bitxor(self, other: m8x16) -> m8x16

Performs the ^ operation.

impl BitXor<bool> for bool

type Output = bool

The resulting type after applying the ^ operator.

fn bitxor(self, other: bool) -> bool

Performs the ^ operation.

impl BitXor<m32x8> for bool

type Output = m32x8

The resulting type after applying the ^ operator.

fn bitxor(self, other: m32x8) -> m32x8

Performs the ^ operation.

impl BitXor<m64x2> for bool

type Output = m64x2

The resulting type after applying the ^ operator.

fn bitxor(self, other: m64x2) -> m64x2

Performs the ^ operation.

impl BitXor<m16x8> for bool

type Output = m16x8

The resulting type after applying the ^ operator.

fn bitxor(self, other: m16x8) -> m16x8

Performs the ^ operation.

impl BitXor<m16x16> for bool

type Output = m16x16

The resulting type after applying the ^ operator.

fn bitxor(self, other: m16x16) -> m16x16

Performs the ^ operation.

impl BitXor<m16x2> for bool

type Output = m16x2

The resulting type after applying the ^ operator.

fn bitxor(self, other: m16x2) -> m16x2

Performs the ^ operation.

impl Ord for bool

fn cmp(&self, other: &bool) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

impl<'a> Not for &'a bool

type Output = <bool as Not>::Output

The resulting type after applying the ! operator.

fn not(self) -> <bool as Not>::Output

Performs the unary ! operation.

impl Not for bool

type Output = bool

The resulting type after applying the ! operator.

fn not(self) -> bool

Performs the unary ! operation.

impl Eq for bool

impl PartialEq<bool> for bool

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Display for bool

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

Formats the value using the given formatter.

impl Hash for bool

fn hash<H>(&self, state: &mut H) where     H: Hasher,

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where     H: Hasher,

Feeds a slice of this type into the given [Hasher].