Inheritance diagram for xtd::collections::bit_array:

Definition

Manages a compact array of bit values, which are represented as booleans, where true indicates that the bit is on (1) and false indicates the bit is off (0).

class core_export_ bit_array : public xtd::object, public xtd::iequatable<bit_array>, public xtd::collections::generic::icollection<bool>, public xtd::iclonable;

xtd::collections::bit_array::bit_array

bit_array(xtd::usize length) noexcept

Initializes a new instance of the xtd::collections::bit_array class that can hold the specified numbe...

xtd::collections::generic::icollection

Defines methods to manipulate generic collections.

Definition icollection.hpp:45

xtd::iclonable

Supports cloning, which creates a new instance of a class with the same value as an existing instance...

Definition iclonable.hpp:21

xtd::iequatable

Defines a generalized method that a value type or class implements to create a type-specific method f...

Definition iequatable.hpp:23

xtd::object

Supports all classes in the xtd class hierarchy and provides low-level services to derived classes....

Definition object.hpp:45

core_export_

#define core_export_

Define shared library export.

Definition core_export.hpp:13

Header: #include <xtd/collections/bit_array>

Namespace: xtd::collections

Library: xtd.core

Examples: The following code example shows how to create and initialize a xtd::collections::bit_array and how to print out its values.
#include <xtd/xtd>

class program {

public:

static auto main() -> void {

// Creates and initializes several bit_arrays.

auto my_ba1 = collections::bit_array(5_z);

auto my_ba2 = collections::bit_array(5_z, false);

auto my_bytes = array {1_u8, 2_u8, 3_u8, 4_u8, 5_u8};

auto my_ba3 = collections::bit_array(my_bytes);

auto my_bools = array {true, false, true, true, false};

auto my_ba4 = collections::bit_array(my_bools);

auto my_ints = array {6, 7, 8, 9, 10};

auto my_ba5 = collections::bit_array(my_ints);

// Displays the properties and values of the bit_arrays.

console::write_line("my_ba1");

console::write_line(" count: {0}", my_ba1.count());

console::write_line(" length: {0}", my_ba1.length());

console::write_line(" values:");

print_values(my_ba1, 8);

console::write_line("my_ba2");

console::write_line(" count: {0}", my_ba2.count());

console::write_line(" length: {0}", my_ba2.length());

console::write_line(" values:");

print_values(my_ba2, 8);

console::write_line("my_ba3");

console::write_line(" count: {0}", my_ba3.count());

console::write_line(" length: {0}", my_ba3.length());

console::write_line(" values:");

print_values(my_ba3, 8);

console::write_line("my_ba4");

console::write_line(" count: {0}", my_ba4.count());

console::write_line(" length: {0}", my_ba4.length());

console::write_line(" values:");

print_values(my_ba4, 8);

console::write_line("my_ba5");

console::write_line(" count: {0}", my_ba5.count());

console::write_line(" length: {0}", my_ba5.length());

console::write_line(" values:");

print_values(my_ba5, 8);

}

template<typename object_t>

static auto print_values(const ienumerable<object_t>& my_list, int my_width) -> void {

auto i = my_width;

for (auto obj : my_list) {

if (i <= 0) {

i = my_width;

console::write_line();

}

i--;

console::write("{,8}", obj);

}

console::write_line();

}

};

startup_(program::main);

// This code produces the following output :

//

// my_ba1

// count: 5

// length: 5

// values:

// false false false false false

// my_ba2

// count: 5

// length: 5

// values:

// false false false false false

// my_ba3

// count: 40

// length: 40

// values:

// true false false false false false false false

// false true false false false false false false

// true true false false false false false false

// false false true false false false false false

// true false true false false false false false

// my_ba4

// count: 5

// length: 5

// values:

// true false true true false

// my_ba5

// count: 160

// length: 160

// values:

// false true true false false false false false

// false false false false false false false false

// false false false false false false false false

// false false false false false false false false

// true true true false false false false false

// false false false false false false false false

// false false false false false false false false

// false false false false false false false false

// false false false true false false false false

// false false false false false false false false

// false false false false false false false false

// false false false false false false false false

// true false false true false false false false

// false false false false false false false false

// false false false false false false false false

// false false false false false false false false

// false true false true false false false false

// false false false false false false false false

// false false false false false false false false

// false false false false false false false false

xtd::array
Provides methods for creating, manipulating, searching, and sorting arrays, thereby serving as the ba...
Definition array.hpp:64

xtd::collections::bit_array
Manages a compact array of bit values, which are represented as booleans, where true indicates that t...
Definition bit_array.hpp:41

xtd::console::write
static auto write(arg_t &&value) -> void
Writes the text representation of the specified value to the standard output stream.
Definition console.hpp:480

xtd::console::write_line
static auto write_line() -> void
Writes the current line terminator to the standard output stream using the specified format informati...

startup_
#define startup_(...)
Defines the entry point to be called when the application loads. Generally this is set either to the ...
Definition startup.hpp:284

xtd::console_key::i
@ i
The I key.
Definition console_key.hpp:104

Public Aliases
using	value_type
	Represents the list value type.
using	base_type
	Represents the list base type.
using	size_type
	Represents the list size type (usually xtd::usize).
using	difference_type
	Represents the list difference type (usually xtd::ptrdiff).
using	reference
	Represents the reference of list value type.
using	const_reference
	Represents the const reference of list value type.
using	pointer
	Represents the pointer of list value type.
using	const_pointer
	Represents the const pointer of list value type.

Public Constructors
	bit_array (xtd::usize length) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that can hold the specified number of bit values, which are initially set to false.
	bit_array (xtd::usize length, bool defaultValue) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that can hold the specified number of bit values, which are initially set to the specified value.
	bit_array (std::initializer_list< bool > il) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified initializer list of booleans.
	bit_array (const xtd::array< bool > &values) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified array of booleans.
	bit_array (const xtd::array< xtd::byte > &values) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified array of bytes.
	bit_array (const xtd::array< int32 > &values) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified array of 32-bit integers.
template<xtd::usize length>
	bit_array (const std::bitset< length > &bit_set) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified bitset.
	bit_array (const std::vector< bool > &booleans) noexcept
	Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified std::vector<bool>.

Public Properties
template<xtd::usize length>
auto	bits () const noexcept -> std::bitset< length >
	Returns a std::bitset object containing the Booleans contained in the current xtd::collections::bit_array.
auto	bits () const noexcept -> std::vector< bool >
	Returns a std::vector<bool> object containing the Booleans contained in the current xtd::collections::bit_array.
auto	count () const noexcept -> xtd::usize override
	Gets the number of elements contained in the xtd::collections::bit_array.
auto	length () const noexcept -> xtd::usize
	Gets the number of elements contained in the xtd::collections::bit_array.
auto	length (xtd::usize value) -> void
	Sets the number of elements contained in the xtd::collections::bit_array.

Public Methods
auto	and_ (const bit_array &value) -> const bit_array &
	Performs the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
xtd::uptr< xtd::object >	clone () const override
	Creates a new object that is a copy of the current instance.
auto	copy_to (xtd::array< bool > &array, xtd::usize index) const -> void override
	Copies the elements of the xtd::collections::bit_array to an xtd::array, starting at a particular xtd::array index.
auto	equals (const bit_array &value) const noexcept -> bool override
	Determines whether this instance of xtd::collections::bit_array and a specified object, which must also be a xtd::collections::bit_array object, have the same value.
auto	equals (const object &obj) const noexcept -> bool override
	Determines whether this instance of xtd::collections::bit_array and a specified object, which must also be a xtd::collections::bit_array object, have the same value.
auto	get (xtd::usize index) const -> bool
	Gets the value of the bit at a specific position in the xtd::collections::bit_array.
auto	get (xtd::usize index) -> bool &
	Gets the value of the bit at a specific position in the xtd::collections::bit_array.
xtd::collections::generic::enumerator< bool >	get_enumerator () const override
	Returns an enumerator that iterates through a collection.
auto	has_all_set () const noexcept -> bool
	Determines whether all bits in the xtd::collections::bit_array are set to true.
auto	has_any_set () const noexcept -> bool
	Determines whether any bit in the xtd::collections::bit_array is set to true.
auto	left_shift (xtd::usize count) noexcept -> bit_array &
	Shifts all the bit values of the current xtd::collections::bit_array to the left on count bits.
auto	not_ () -> const bit_array &
	Inverts all the bit values in the current xtd::collections::bit_array, so that elements set to true are changed to false, and elements set to false are changed to true.
auto	or_ (const bit_array &value) -> const bit_array &
	Performs the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	right_shift (xtd::usize count) noexcept -> bit_array &
	Shifts all the bit values of the current xtd::collections::bit_array to the right on count bits.
auto	set (xtd::usize index, bool value) -> void
	Sets the value of the bit at a specific position in the xtd::collections::bit_array.
auto	set_all (bool value) -> void
	Sets all bits in the xtd::collections::bit_array to the specified value.
auto	to_string () const noexcept -> xtd::string override
	Returns a xtd::string that represents the current object.
auto	xor_ (const bit_array &value) -> const bit_array &
	Performs the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Public Operators
auto	operator[] (xtd::usize index) const -> const bool &
	Gets the element at the specified index.
auto	operator[] (xtd::usize index) -> bool &
	Gets or Sets the element at the specified index.
auto	operator& (const bit_array &value) const -> bit_array
	Performs the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	operator&= (const bit_array &value) -> bit_array &
	Performs the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	operator\| (const bit_array &value) const -> bit_array
	Performs the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	operator\|= (const bit_array &value) -> bit_array &
	Performs the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	operator^ (const bit_array &value) const -> bit_array
	Performs the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	operator^= (const bit_array &value) -> bit_array &
	Performs the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.
auto	operator~ () const -> bit_array
	Inverts all the bit values in the current xtd::collections::bit_array, so that elements set to true are changed to false, and elements set to false are changed to true.
auto	operator>> (xtd::usize count) const noexcept -> bit_array
	The right shift operator shifts all the bit values of the current xtd::collections::bit_array to the right on count bits.
auto	operator>>= (xtd::usize count) noexcept -> bit_array &
	The right shift operator shifts all the bit values of the current xtd::collections::bit_array to the right on count bits.
auto	operator<< (xtd::usize count) const noexcept -> bit_array
	The left shift operator shifts all the bit values of the current xtd::collections::bit_array to the left on count bits.
auto	operator<<= (xtd::usize count) noexcept -> bit_array &
	The left shift operator shifts all the bit values of the current xtd::collections::bit_array to the left on count bits.

Additional Inherited Members
using	value_type
	Represents the xtd::collections::generic::icollection value type.
using	value_type
	Represents the xtd::collections::generic::ienumerable value type.
using	iterator
	Represents the iterator of xtd::collections::generic::ienumerable value type.
using	const_iterator
	Represents the const iterator of xtd::collections::generic::ienumerable value type.
using	iterator
	Represents the iterator of enumerable value type.
using	const_iterator
	Represents the const iterator of enumerable value type.
using	enumerable_type
	Represents the ienumerable enumerable type.
using	source_type
	Represents the ienumerable source type.
using	ienumerable
	Represents the ienumerable value type.
using	list
	Represents the list value type.
	object ()=default
	Create a new instance of the ultimate base class object.
virtual auto	get_hash_code () const noexcept -> xtd::usize
	Serves as a hash function for a particular type.
virtual auto	get_type () const noexcept -> type_object
	Gets the type of the current instance.
template<typename object_t>
auto	memberwise_clone () const -> xtd::unique_ptr_object< object_t >
	Creates a shallow copy of the current object.
virtual auto	equals (const bit_array &) const noexcept -> bool=0
	Indicates whether the current object is equal to another object of the same type.
virtual auto	begin () const -> const_iterator
	Returns an iterator to the first element of the enumerable.
virtual auto	cbegin () const -> const_iterator
	Returns an iterator to the first element of the enumerable.
virtual auto	cend () const -> const_iterator
	Returns an iterator to the element following the last element of the enumerable.
virtual auto	end () const -> const_iterator
	Returns an iterator to the element following the last element of the enumerable.
auto	aggregate (const std::function< bool(const bool &, const bool &)> &funcfunc) const -> bool
	Applies an accumulator function over a sequence.
auto	all (const std::function< bool(const bool &)> &predicatepredicate) const -> bool
	Determines whether all elements of a sequence satisfy a condition.
auto	any () const noexcept -> bool
	Determines whether a sequence contains any elements.
auto	append (const bool &element) const noexcept
	Appends a value to the end of the sequence.
auto	as_enumerable () const noexcept
	Returns the input typed as xtd::collections::generic::ienumerable <type_t>.
auto	average () const noexcept
	Computes the average of a sequence of source_t values.
auto	cast () const noexcept
	Casts the elements of an xtd::collections::generic::ienumerable to the specified type.
auto	chunk (xtd::usize size) const
	Splits the elements of a sequence into chunks of size at most size.
auto	concat (const ienumerable< bool > &second) const noexcept
	Concatenates two sequences.
auto	contains (const bool &value) const noexcept -> bool
	Determines whether a sequence contains a specified element by using the default equality comparer.
auto	count () const noexcept -> xtd::usize
	Returns the number of elements in current sequence.
auto	count_by (const std::function< key_t(const bool &)> &key_selector) const noexcept
	Returns the count of elements in the current sequence grouped by key.
auto	default_if_empty () const noexcept
	Returns the elements of the specified sequence or the type parameter's default value in a singleton collection if the current sequence is empty.
auto	distinct () const noexcept
	Returns distinct elements from a sequence by using the default equality comparer to compare values.
auto	first_or_default (const std::function< bool(const bool &)> &predicatepredicate, const bool &default_value) const noexcept -> bool
	Returns the first element of the sequence that satisfies a condition, or a specified default value if no such element is found.
auto	order () const
	Sorts the elements of a sequence in ascending order.
auto	order_by (const std::function< bool(const bool &)> &key_selector) const
	Sorts the elements of a sequence in ascending order according to a key.
auto	order_by_descending (const std::function< key_t(const bool &)> &key_selector) const
	Sorts the elements of a sequence in descending order according to a key.
auto	select (auto &&selector) const
	Projects each element of a sequence into a new form.
auto	to_array () const noexcept -> xtd::array< bool >
	Creates a xtd::array <type_t> from an xtd::collections::generic::ienumerable <type_t>.
auto	to_list () const noexcept -> xtd::collections::generic::list< bool >
	Creates a xtd::collections::generic::list <type_t> from an xtd::collections::generic::ienumerable <type_t>.
auto	where (auto &&predicatepredicate) const
	Filters a sequence of values based on a predicate.
virtual auto	empty () const noexcept -> bool
	Checks whether the container is empty.
virtual auto	size () const noexcept -> xtd::usize
	Gets the number of elements contained in the xtd::collections::generic::icollection <type_t>.
virtual auto	operator<< (const bool &item) -> icollection< bool > &
	The shift left operator adds an item to the xtd::collections::generic::icollection <type_t>.
virtual auto	operator>> (const bool &item) -> icollection< bool > &
	The shift right operator removes the first occurrence of a specific object from the xtd::collections::generic::icollection <type_t>.
template<typename object_a_t, typename object_b_t>
static auto	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are considered equal.
template<typename object_a_t, typename object_b_t>
static auto	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are the same instance.
static auto	to_const_iterator (typename source_collection_t::const_iterator &value, const source_collection_t &source_collection, const target_collection_t &target_collection) noexcept -> typename target_collection_t::const_iterator
	Converts source iterator to target iterator.
static auto	to_iterator (typename source_collection_t::const_iterator &value, const source_collection_t &source_collection, const target_collection_t &target_collection) noexcept -> typename target_collection_t::const_iterator
	Converts source iterator to target iterator.

Member Typedef Documentation

◆ value_type

using xtd::collections::bit_array::value_type

Represents the list value type.

◆ base_type

using xtd::collections::bit_array::base_type

Represents the list base type.

◆ size_type

using xtd::collections::bit_array::size_type

Represents the list size type (usually xtd::usize).

◆ difference_type

using xtd::collections::bit_array::difference_type

Represents the list difference type (usually xtd::ptrdiff).

◆ reference

using xtd::collections::bit_array::reference

Represents the reference of list value type.

◆ const_reference

using xtd::collections::bit_array::const_reference

Represents the const reference of list value type.

◆ pointer

using xtd::collections::bit_array::pointer

Represents the pointer of list value type.

◆ const_pointer

using xtd::collections::bit_array::const_pointer

Represents the const pointer of list value type.

Constructor & Destructor Documentation

◆ bit_array() [1/8]

xtd::collections::bit_array::bit_array ( xtd::usize length )

explicitnoexcept

Initializes a new instance of the xtd::collections::bit_array class that can hold the specified number of bit values, which are initially set to false.

Parameters

length_ The number of bit values in the new xtd::collections::bit_array.

Exceptions

xtd::argument_out_of_range_exception length_ is less than 0.

Remarks: This constructor is an O(n) operation, where n is length_.

◆ bit_array() [2/8]

xtd::collections::bit_array::bit_array	(	xtd::usize	length,
		bool	defaultValue )

noexcept

Initializes a new instance of the xtd::collections::bit_array class that can hold the specified number of bit values, which are initially set to the specified value.

Parameters

length_	The number of bit values in the new xtd::collections::bit_array.
defaultValueThe	bool value to assign to each bit.

Exceptions

xtd::argument_out_of_range_exception length_ is less than 0.

Remarks: This constructor is an O(n) operation, where n is length_.

◆ bit_array() [3/8]

xtd::collections::bit_array::bit_array ( std::initializer_list< bool > il )

noexcept

Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified initializer list of booleans.

Parameters

values An array of booleans to copy.

Remarks: This constructor is an O(n) operation, where n is the number of elements in values.

◆ bit_array() [4/8]

xtd::collections::bit_array::bit_array ( const xtd::array< bool > & values )

noexcept

Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified array of booleans.

Parameters

values An initializer list of booleans to copy.

Remarks: This constructor is an O(n) operation, where n is the number of elements in values.

◆ bit_array() [5/8]

xtd::collections::bit_array::bit_array ( const xtd::array< xtd::byte > & values )

noexcept

Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified array of bytes.

Parameters

values An array of bytes containing the values to copy, where each byte represents eight consecutive bits.

Remarks: The first byte in the array represents bits 0 through 7, the second byte represents bits 8 through 15, and so on. The Least Significant Bit of each byte represents the lowest index value: " bytes [0] & 1" represents bit 0, " bytes [0] & 2" represents bit 1, " bytes [0] & 4" represents bit 2, and so on.; This constructor is an O(n) operation, where n is the number of elements in values.

◆ bit_array() [6/8]

xtd::collections::bit_array::bit_array ( const xtd::array< int32 > & values )

noexcept

Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified array of 32-bit integers.

Parameters

values An array of integers containing the values to copy, where each integer represents 32 consecutive bits.

Remarks: The number in the first values array element represents bits 0 through 31, the second number in the array represents bits 32 through 63, and so on. The Least Significant Bit of each integer represents the lowest index value: " values [0] & 1" represents bit 0, " values [0] & 2" represents bit 1, " values [0] & 4" represents bit 2, and so on.; This constructor is an O(n) operation, where n is the number of elements in values.

◆ bit_array() [7/8]

template<xtd::usize length>

xtd::collections::bit_array::bit_array ( const std::bitset< length > & bit_set )

inlinenoexcept

Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified bitset.

Parameters

values A std::bitset object that contains bit values.

Remarks: This constructor is an O(n) operation, where n is the number of elements in values.

◆ bit_array() [8/8]

xtd::collections::bit_array::bit_array ( const std::vector< bool > & booleans )

noexcept

Initializes a new instance of the xtd::collections::bit_array class that contains bit values copied from the specified std::vector<bool>.

Parameters

values A std::vector<bool> object that contains bit values.

Remarks: This constructor is an O(n) operation, where n is the number of elements in values.

Member Function Documentation

◆ bits() [1/2]

template<xtd::usize length>

auto xtd::collections::bit_array::bits ( ) const -> std::bitset< length >

inlinenodiscardnoexcept

Returns a std::bitset object containing the Booleans contained in the current xtd::collections::bit_array.

Returns: The std::bitset object.

◆ bits() [2/2]

auto xtd::collections::bit_array::bits ( ) const -> std::vector< bool >

inlinenodiscardnoexcept

Returns a std::vector<bool> object containing the Booleans contained in the current xtd::collections::bit_array.

Returns: The std::vector<bool> object.

◆ count()

auto xtd::collections::bit_array::count ( ) const -> xtd::usize

nodiscardoverridevirtualnoexcept

Gets the number of elements contained in the xtd::collections::bit_array.

Returns: The number of elements contained in the xtd::collections::bit_array.

Remarks: Retrieving the value of this property is an O(1) operation; setting the property is an O(n) operation, where n is the new capacity.

Implements xtd::collections::generic::icollection< bool >.

◆ length() [1/2]

auto xtd::collections::bit_array::length ( ) const -> xtd::usize

nodiscardnoexcept

Gets the number of elements contained in the xtd::collections::bit_array.

Returns: The number of elements contained in the xtd::collections::bit_array.

Remarks: xtd::collections::bit_array::length and xtd::collections::bit_array::count return the same value. xtd::collections::bit_array::length can be set to a specific value.

◆ length() [2/2]

auto xtd::collections::bit_array::length ( xtd::usize value ) -> void

Sets the number of elements contained in the xtd::collections::bit_array.

Parameters

value The number of elements contained in the xtd::collections::bit_array.

Remarks: xtd::collections::bit_array::length and xtd::collections::bit_array::count return the same value. xtd::collections::bit_array::length can be set to a specific value.

◆ and_()

auto xtd::collections::bit_array::and_ ( const bit_array & value ) -> const bit_array &

Performs the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise AND operation.

Returns: The current instance containing the result of the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise AND operation returns true if both operands are true, and returns false if one or both operands are false.; This method is an O(n) operation, where n is count.

◆ clone()

xtd::uptr< xtd::object > xtd::collections::bit_array::clone ( ) const

nodiscardoverridevirtual

Creates a new object that is a copy of the current instance.

Returns: A new object that is a copy of this instance.

Implements xtd::iclonable.

◆ copy_to()

auto xtd::collections::bit_array::copy_to	(	xtd::array< bool > &	array,
		xtd::usize	index ) const -> void

overridevirtual

Copies the elements of the xtd::collections::bit_array to an xtd::array, starting at a particular xtd::array index.

Parameters

array	The one-dimensional xtd::array that is the destination of the elements copied from xtd::collections::bit_array. The xtd::array must have zero-based indexing.
index	The zero-based index in array at which copying begins;

Returns: Number of elements copied.

Implements xtd::collections::generic::icollection< bool >.

◆ equals() [1/2]

auto xtd::collections::bit_array::equals ( const bit_array & value ) const -> bool

nodiscardoverridenoexcept

Determines whether this instance of xtd::collections::bit_array and a specified object, which must also be a xtd::collections::bit_array object, have the same value.

Parameters

value The xtd::collections::bit_array to compare with the current object.

Returns: true if the specified value is equal to the current object. otherwise, false.

◆ equals() [2/2]

auto xtd::collections::bit_array::equals ( const object & obj ) const -> bool

nodiscardoverridevirtualnoexcept

Determines whether this instance of xtd::collections::bit_array and a specified object, which must also be a xtd::collections::bit_array object, have the same value.

Parameters

obj	The object to compare with the current object.

Returns: true if the specified object is equal to the current object. otherwise, false.

Reimplemented from xtd::object.

◆ get() [1/2]

auto xtd::collections::bit_array::get ( xtd::usize index ) const -> bool

nodiscard

Gets the value of the bit at a specific position in the xtd::collections::bit_array.

Parameters

index The zero-based index of the value to get.

Returns: The value of the bit at position index.

Exceptions

xtd::argument_out_of_range_exception index is less than zero. -or- index is greater than or equal to the number of elements in the xtd::collections::bit_array.

Remarks: This method is an O(1) operation.

◆ get() [2/2]

auto xtd::collections::bit_array::get ( xtd::usize index ) -> bool &

nodiscard

Gets the value of the bit at a specific position in the xtd::collections::bit_array.

Parameters

index The zero-based index of the value to get.

Returns: The value of the bit at position index.

Exceptions

xtd::argument_out_of_range_exception index is less than zero. -or- index is greater than or equal to the number of elements in the xtd::collections::bit_array.

Remarks: This method is an O(1) operation.

◆ get_enumerator()

xtd::collections::generic::enumerator< bool > xtd::collections::bit_array::get_enumerator ( ) const

nodiscardoverridevirtual

Returns an enumerator that iterates through a collection.

Returns: An xtd::collections::generic::ienumerator object that can be used to iterate through the collection.

Implements xtd::collections::generic::icollection< bool >.

◆ has_all_set()

auto xtd::collections::bit_array::has_all_set ( ) const -> bool

nodiscardnoexcept

Determines whether all bits in the xtd::collections::bit_array are set to true.

Returns: true if every bit in the xtd::collections::bit_array is set to true, or if xtd::collections::bit_array is empty; otherwise, false.

◆ has_any_set()

auto xtd::collections::bit_array::has_any_set ( ) const -> bool

nodiscardnoexcept

Determines whether any bit in the xtd::collections::bit_array is set to true.

Returns: true if xtd::collections::bit_array is not empty and at least one of its bit is set to true; otherwise, false.

◆ left_shift()

auto xtd::collections::bit_array::left_shift ( xtd::usize count ) -> bit_array &

noexcept

Shifts all the bit values of the current xtd::collections::bit_array to the left on count bits.

Parameters

count The number of shifts to make for each bit.

Returns: The current xtd::collections::bit_array.

Remarks: The current xtd::collections::bit_array is updated and returned.

◆ not_()

auto xtd::collections::bit_array::not_ ( ) -> const bit_array &

Inverts all the bit values in the current xtd::collections::bit_array, so that elements set to true are changed to false, and elements set to false are changed to true.

Returns: The current instance with inverted bit values.

Remarks: This method is an O(n) operation, where n is count.

◆ or_()

auto xtd::collections::bit_array::or_ ( const bit_array & value ) -> const bit_array &

Performs the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise OR operation.

Returns: The current instance containing the result of the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise OR operation returns true if one or both operands are true, and returns false if both operands are false.; This method is an O(n) operation, where n is count.

◆ right_shift()

auto xtd::collections::bit_array::right_shift ( xtd::usize count ) -> bit_array &

noexcept

Shifts all the bit values of the current xtd::collections::bit_array to the right on count bits.

Parameters

count The number of shifts to make for each bit.

Returns: The current xtd::collections::bit_array.

Remarks: The current xtd::collections::bit_array is updated and returned.

◆ set()

auto xtd::collections::bit_array::set	(	xtd::usize	index,
		bool	value ) -> void

Sets the value of the bit at a specific position in the xtd::collections::bit_array.

Parameters

index	The zero-based index of the value to get.
value	The bool value to assign to the bit.

Exceptions

xtd::argument_out_of_range_exception index is less than zero. -or- index is greater than or equal to the number of elements in the xtd::collections::bit_array.

Remarks: This method is an O(1) operation.

◆ set_all()

auto xtd::collections::bit_array::set_all ( bool value ) -> void

Sets all bits in the xtd::collections::bit_array to the specified value.

Parameters

value The bool value to assign to all bits.

Remarks: This method is an O(n) operation, where n is count.

◆ to_string()

auto xtd::collections::bit_array::to_string ( ) const -> xtd::string

nodiscardoverridevirtualnoexcept

Returns a xtd::string that represents the current object.

Returns: A string that represents the current object.

Reimplemented from xtd::object.

◆ xor_()

auto xtd::collections::bit_array::xor_ ( const bit_array & value ) -> const bit_array &

Performs the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise exclusive OR operation.

Returns: The current instance containing the result of the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise exclusive OR operation returns true if exactly one operand is true, and returns false if both operands have the same bool value.; This method is an O(n) operation, where n is count.

◆ operator[]() [1/2]

auto xtd::collections::bit_array::operator[] ( xtd::usize index ) const -> const bool &

Gets the element at the specified index.

Parameters

index The zero-based index of the element to get.

Returns: The element at the specified index.

Exceptions

xtd::argument_out_of_range_exception index is less than 0 or index is equal to or greater than count.

◆ operator[]() [2/2]

auto xtd::collections::bit_array::operator[] ( xtd::usize index ) -> bool &

Gets or Sets the element at the specified index.

Parameters

index The zero-based index of the element to get.

Returns: The element at the specified index.

Exceptions

xtd::argument_out_of_range_exception index is less than 0 or index is equal to or greater than count.

◆ operator&()

auto xtd::collections::bit_array::operator& ( const bit_array & value ) const -> bit_array

Performs the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise AND operation.

Returns: The new instance containing the result of the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise AND operation returns true if both operands are true, and returns false if one or both operands are false.; This method is an O(n) operation, where n is count.

◆ operator&=()

auto xtd::collections::bit_array::operator&= ( const bit_array & value ) -> bit_array &

Performs the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise AND operation.

Returns: The current instance containing the result of the bitwise AND operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise AND operation returns true if both operands are true, and returns false if one or both operands are false.; This method is an O(n) operation, where n is count.

◆ operator|()

auto xtd::collections::bit_array::operator| ( const bit_array & value ) const -> bit_array

Performs the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise OR operation.

Returns: The new instance containing the result of the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise OR operation returns true if one or both operands are true, and returns false if both operands are false.; This method is an O(n) operation, where n is count.

◆ operator|=()

auto xtd::collections::bit_array::operator|= ( const bit_array & value ) -> bit_array &

Performs the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise OR operation.

Returns: The current instance containing the result of the bitwise OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise OR operation returns true if one or both operands are true, and returns false if both operands are false.; This method is an O(n) operation, where n is count.

◆ operator^()

auto xtd::collections::bit_array::operator^ ( const bit_array & value ) const -> bit_array

Performs the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise exclusive OR operation.

Returns: The new instance containing the result of the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise exclusive OR operation returns true if exactly one operand is true, and returns false if both operands have the same bool value.; This method is an O(n) operation, where n is count.

◆ operator^=()

auto xtd::collections::bit_array::operator^= ( const bit_array & value ) -> bit_array &

Performs the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Parameters

value The xtd::collections::bit_array with which to perform the bitwise exclusive OR operation.

Returns: The current instance containing the result of the bitwise exclusive OR operation on the elements in the current xtd::collections::bit_array against the corresponding elements in the specified xtd::collections::bit_array.

Exceptions

xtd::argument_exception value and the current xtd::collections::bit_array do not have the same number of elements.

Remarks: The bitwise exclusive OR operation returns true if exactly one operand is true, and returns false if both operands have the same bool value.; This method is an O(n) operation, where n is count.

◆ operator~()

auto xtd::collections::bit_array::operator~ ( ) const -> bit_array

Inverts all the bit values in the current xtd::collections::bit_array, so that elements set to true are changed to false, and elements set to false are changed to true.

Returns: The new instance with inverted bit values.

Remarks: This method is an O(n) operation, where n is count.

◆ operator>>()

auto xtd::collections::bit_array::operator>> ( xtd::usize count ) const -> bit_array

noexcept

The right shift operator shifts all the bit values of the current xtd::collections::bit_array to the right on count bits.

Parameters

count The number of shifts to make for each bit.

Returns: The new shifted xtd::collections::bit_array.

Remarks: The current xtd::collections::bit_array is not updated.

◆ operator>>=()

auto xtd::collections::bit_array::operator>>= ( xtd::usize count ) -> bit_array &

noexcept

The right shift operator shifts all the bit values of the current xtd::collections::bit_array to the right on count bits.

Parameters

count The number of shifts to make for each bit.

Returns: The current xtd::collections::bit_array.

Remarks: The current xtd::collections::bit_array is updated and returned.

◆ operator<<()

auto xtd::collections::bit_array::operator<< ( xtd::usize count ) const -> bit_array

noexcept

The left shift operator shifts all the bit values of the current xtd::collections::bit_array to the left on count bits.

Parameters

count The number of shifts to make for each bit.

Returns: The new shifted xtd::collections::bit_array.

Remarks: The current xtd::collections::bit_array is not updated.

◆ operator<<=()

auto xtd::collections::bit_array::operator<<= ( xtd::usize count ) -> bit_array &

noexcept

The left shift operator shifts all the bit values of the current xtd::collections::bit_array to the left on count bits.

Parameters

count The number of shifts to make for each bit.

Returns: The current xtd::collections::bit_array.

Remarks: The current xtd::collections::bit_array is updated and returned.

The documentation for this class was generated from the following file:

xtd.core/include/xtd/collections/bit_array.hpp

Definition

Public Aliases

Public Constructors

Public Properties

Public Methods

Public Operators

Additional Inherited Members

Member Typedef Documentation

◆ value_type

◆ base_type

◆ size_type

◆ difference_type

◆ reference

◆ const_reference

◆ pointer

◆ const_pointer

Constructor & Destructor Documentation

◆ bit_array() [1/8]

◆ bit_array() [2/8]

◆ bit_array() [3/8]

◆ bit_array() [4/8]

◆ bit_array() [5/8]

◆ bit_array() [6/8]

◆ bit_array() [7/8]

◆ bit_array() [8/8]

Member Function Documentation

◆ bits() [1/2]

◆ bits() [2/2]

◆ count()

◆ length() [1/2]

◆ length() [2/2]

◆ and_()

◆ clone()

◆ copy_to()

◆ equals() [1/2]

◆ equals() [2/2]

◆ get() [1/2]

◆ get() [2/2]

◆ get_enumerator()

◆ has_all_set()

◆ has_any_set()

◆ left_shift()

◆ not_()

◆ or_()

◆ right_shift()

◆ set()

◆ set_all()

◆ to_string()

◆ xor_()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ operator&()

◆ operator&=()

◆ operator|()

◆ operator|=()

◆ operator^()

◆ operator^=()

◆ operator~()

◆ operator>>()

◆ operator>>=()

◆ operator<<()

◆ operator<<=()