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.
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
.
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:
impl Copy for bool
[src]
impl<'a> BitXor<bool> for &'a bool
[src]
type Output = <bool as BitXor<bool>>::Output
The resulting type after applying the ^
operator.
fn bitxor(self, other: bool) -> <bool as BitXor<bool>>::Output
[src]
impl<'_, '_> BitXor<&'_ bool> for &'_ bool
[src]
type Output = <bool as BitXor<bool>>::Output
The resulting type after applying the ^
operator.
fn bitxor(self, other: &bool) -> <bool as BitXor<bool>>::Output
[src]
impl BitXor<bool> for bool
[src]
type Output = bool
The resulting type after applying the ^
operator.
fn bitxor(self, other: bool) -> bool
[src]
impl<'_> BitXor<&'_ bool> for bool
[src]
type Output = <bool as BitXor<bool>>::Output
The resulting type after applying the ^
operator.
fn bitxor(self, other: &bool) -> <bool as BitXor<bool>>::Output
[src]
impl BitXorAssign<bool> for bool
[src]1.8.0
fn bitxor_assign(&mut self, other: bool)
[src]
impl<'_> BitXorAssign<&'_ bool> for bool
[src]1.22.0
fn bitxor_assign(&mut self, other: &bool)
[src]
impl Default for bool
[src]
impl Hash for bool
[src]
fn hash<H>(&self, state: &mut H) where
H: Hasher,
[src]
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
[src]1.3.0
Feeds a slice of this type into the given [Hasher
]. Read more
impl<'_> BitOr<&'_ bool> for bool
[src]
type Output = <bool as BitOr<bool>>::Output
The resulting type after applying the |
operator.
fn bitor(self, other: &bool) -> <bool as BitOr<bool>>::Output
[src]
impl<'_, '_> BitOr<&'_ bool> for &'_ bool
[src]
type Output = <bool as BitOr<bool>>::Output
The resulting type after applying the |
operator.
fn bitor(self, other: &bool) -> <bool as BitOr<bool>>::Output
[src]
impl<'a> BitOr<bool> for &'a bool
[src]
type Output = <bool as BitOr<bool>>::Output
The resulting type after applying the |
operator.
fn bitor(self, other: bool) -> <bool as BitOr<bool>>::Output
[src]
impl BitOr<bool> for bool
[src]
type Output = bool
The resulting type after applying the |
operator.
fn bitor(self, rhs: bool) -> bool
[src]
impl Clone for bool
[src]
fn clone(&self) -> bool
[src]
fn clone_from(&mut self, source: &Self)
[src]
Performs copy-assignment from source
. Read more
impl Eq for bool
[src]
impl PartialOrd<bool> for bool
[src]
fn partial_cmp(&self, other: &bool) -> Option<Ordering>
[src]
fn lt(&self, other: &Rhs) -> bool
[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
fn le(&self, other: &Rhs) -> bool
[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
fn gt(&self, other: &Rhs) -> bool
[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
fn ge(&self, other: &Rhs) -> bool
[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl BitAnd<bool> for bool
[src]
type Output = bool
The resulting type after applying the &
operator.
fn bitand(self, rhs: bool) -> bool
[src]
impl<'_> BitAnd<&'_ bool> for bool
[src]
type Output = <bool as BitAnd<bool>>::Output
The resulting type after applying the &
operator.
fn bitand(self, other: &bool) -> <bool as BitAnd<bool>>::Output
[src]
impl<'_, '_> BitAnd<&'_ bool> for &'_ bool
[src]
type Output = <bool as BitAnd<bool>>::Output
The resulting type after applying the &
operator.
fn bitand(self, other: &bool) -> <bool as BitAnd<bool>>::Output
[src]
impl<'a> BitAnd<bool> for &'a bool
[src]
type Output = <bool as BitAnd<bool>>::Output
The resulting type after applying the &
operator.
fn bitand(self, other: bool) -> <bool as BitAnd<bool>>::Output
[src]
impl<'_> BitOrAssign<&'_ bool> for bool
[src]1.22.0
fn bitor_assign(&mut self, other: &bool)
[src]
impl BitOrAssign<bool> for bool
[src]1.8.0
fn bitor_assign(&mut self, other: bool)
[src]
impl Ord for bool
[src]
fn cmp(&self, other: &bool) -> Ordering
[src]
fn max(self, other: Self) -> Self
[src]1.21.0
Compares and returns the maximum of two values. Read more
fn min(self, other: Self) -> Self
[src]1.21.0
Compares and returns the minimum of two values. Read more
fn clamp(self, min: Self, max: Self) -> Self
[src]
Restrict a value to a certain interval. Read more
impl Debug for bool
[src]
impl PartialEq<bool> for bool
[src]
impl Display for bool
[src]
impl BitAndAssign<bool> for bool
[src]1.8.0
fn bitand_assign(&mut self, other: bool)
[src]
impl<'_> BitAndAssign<&'_ bool> for bool
[src]1.22.0
fn bitand_assign(&mut self, other: &bool)
[src]
impl<'_> Not for &'_ bool
[src]
type Output = <bool as Not>::Output
The resulting type after applying the !
operator.
fn not(self) -> <bool as Not>::Output
[src]
impl Not for bool
[src]
impl FromStr for bool
[src]
type Err = ParseBoolError
The associated error which can be returned from parsing.
fn from_str(s: &str) -> Result<bool, ParseBoolError>
[src]
Parse a bool
from a string.
Yields a Result<bool, ParseBoolError>
, because s
may or may not actually be parseable.
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.
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/primitive.bool.html