Subtraction operators
Declared in <bdlc_bitarray.h>
Return the value that is the bitwise MINUS of the specified lhs and rhs arrays. The length of the resulting bit array will be the maximum of that of lhs and rhs, with any unmatched high-order lhs bits copied unchanged, and any unmatched high-order rhs bits set to 0. Note that this behavior is consistent with zero-extending a copy of the shorter array.
bdlc::BitArray
operator-(
BitArray const& lhs,
BitArray const& rhs);Return the signed distance between two iterators (see free operator-).
template<>
std::ptrdiff_t
operator-(
CompactedArray_ConstIterator const&,
CompactedArray_ConstIterator const&);template<>
std::ptrdiff_t
operator-<>(
PackedIntArrayConstIterator const&,
PackedIntArrayConstIterator const&);Return an iterator at the negated specified offset from the given iterator (see free operator-).
template<>
CompactedArray_ConstIterator<TYPE>
operator-(
CompactedArray_ConstIterator<TYPE> const&,
std::ptrdiff_t);Return an iterator referencing the location at the specified offset from the location referenced by the specified iterator. The returned iterator, it, referencing a CompactedArray array, remains valid as long as 0 <= it - array.begin() <= array.length(). The behavior is undefined unless CompactedArray_ConstIterator() != iterator and 0 <= iterator - array.begin() - offset <= array.length().
template<class TYPE>
bdlc::CompactedArray_ConstIterator<TYPE>
operator-(
CompactedArray_ConstIterator<TYPE> const& iterator,
std::ptrdiff_t offset);Return the number of elements between the specified lhs and rhs as a signed value. The behavior is undefined unless lhs and rhs reference the same array. Note that the return value is positive when a positive number of rhs++ invocations would result in lhs == rhs, and negative when a positive number of rhs-- invocations would result in lhs == rhs.
template<class TYPE>
std::ptrdiff_t
operator-(
CompactedArray_ConstIterator<TYPE> const& lhs,
CompactedArray_ConstIterator<TYPE> const& rhs);Return the number of elements between specified lhs and rhs. The behavior is undefined unless lhs and rhs reference the same array.
template<class TYPE>
std::ptrdiff_t
operator-(
PackedIntArrayConstIterator<TYPE> const& lhs,
PackedIntArrayConstIterator<TYPE> const& rhs);