bm::sparse_vector< Val, BV >::back_insert_iterator Class Reference

Back insert iterator implements buffered insert, faster than generic access assignment. More...

#include <bmsparsevec.h>

Public Types
typedef std::output_iterator_tag	iterator_category
typedef sparse_vector< Val, BV >	sparse_vector_type
typedef sparse_vector_type *	sparse_vector_type_ptr
typedef sparse_vector_type::value_type	value_type
typedef sparse_vector_type::unsigned_value_type	unsigned_value_type
typedef sparse_vector_type::size_type	size_type
typedef sparse_vector_type::bvector_type	bvector_type
typedef bvector_type::allocator_type	allocator_type
typedef bvector_type::allocator_type::allocator_pool_type	allocator_pool_type
typedef bm::byte_buffer< allocator_type >	buffer_type
typedef void	difference_type
typedef void	pointer
typedef void	reference

Public Member Functions
void	operator= (value_type v)
	push value to the vector More...
back_insert_iterator &	operator* ()
	noop More...
back_insert_iterator &	operator++ ()
	noop More...
back_insert_iterator &	operator++ (int)
	noop More...
void	add (value_type v)
	add value to the container More...
void	add_null ()
	add NULL (no-value) to the container More...
void	add_null (size_type count)
	add a series of consequitve NULLs (no-value) to the container More...
bool	empty () const
	return true if insertion buffer is empty More...
bool	flush ()
	flush the accumulated buffer More...
bvector_type *	get_null_bvect () const BMNOEXCEPT
	Get access to not-null vector. More...
void	add_value_no_null (value_type v)
	add value to the buffer without changing the NULL vector More...
void	disable_set_null () BMNOEXCEPT
	Reconfigure back inserter not to touch the NULL vector. More...
Construction and assignment <br>
	back_insert_iterator ()
	back_insert_iterator (sparse_vector_type *sv)
	back_insert_iterator (const back_insert_iterator &bi)
void	operator= (const back_insert_iterator &bi)
	More...
	back_insert_iterator (back_insert_iterator &&bi) BMNOEXCEPT
	move constructor More...
void	operator= (back_insert_iterator &&bi) BMNOEXCEPT
	move assignment More...
	~back_insert_iterator ()

Protected Types
typedef bvector_type::block_idx_type	block_idx_type

Detailed Description

template<class Val, class BV>
class bm::sparse_vector< Val, BV >::back_insert_iterator

Back insert iterator implements buffered insert, faster than generic access assignment.

Limitations for buffered inserter:

1. Do not use more than one inserter per vector at a time
2. Use method flush() at the end to send the rest of accumulated buffer flush is happening automatically on destruction, but if flush produces an exception (for whatever reason) it will be an exception in destructor. As such, explicit flush() is safer way to finilize the sparse vector load.

Definition at line 255 of file bmsparsevec.h.

Constructor & Destructor Documentation

back_insert_iterator()

template<class Val , class BV >

bm::sparse_vector< Val, BV >::back_insert_iterator::back_insert_iterator

(

back_insert_iterator &&

bi

)

move constructor

Member Function Documentation

add()

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::add

(

value_type

v

)

add value to the container

Definition at line 2471 of file bmsparsevec.h.

References BM_ASSERT.

add_null() [1/2]

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::add_null

add NULL (no-value) to the container

Definition at line 2513 of file bmsparsevec.h.

References BM_ASSERT.

Referenced by main().

add_null() [2/2]

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::add_null

(

size_type

count

)

add a series of consequitve NULLs (no-value) to the container

add_value_no_null()

template<class Val , class BV >

BMFORCEINLINE void bm::sparse_vector< Val, BV >::back_insert_iterator::add_value_no_null

(

value_type

v

)

add value to the buffer without changing the NULL vector

Parameters

v	- value to push back

Definition at line 2493 of file bmsparsevec.h.

References BM_ASSERT, bm::sparse_vector< Val, BV >::n_buf_size, and bm::base_sparse_vector< Val, BV, 1 >::s2u().

disable_set_null()

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::disable_set_null ( )

inline

Reconfigure back inserter not to touch the NULL vector.

Definition at line 354 of file bmsparsevec.h.

empty()

template<class Val , class BV >

bool bm::sparse_vector< Val, BV >::back_insert_iterator::empty

return true if insertion buffer is empty

Definition at line 2540 of file bmsparsevec.h.

Referenced by bm::sparse_vector< Val, BV >::back_insert_iterator::operator=().

flush()

template<class Val , class BV >

bool bm::sparse_vector< Val, BV >::back_insert_iterator::flush

flush the accumulated buffer

Returns

true if actually flushed (back inserter had data to flush)

Definition at line 2548 of file bmsparsevec.h.

References bm::set_block_shift.

get_null_bvect()

template<class Val , class BV >

bvector_type* bm::sparse_vector< Val, BV >::back_insert_iterator::get_null_bvect ( ) const

inline

Get access to not-null vector.

Definition at line 343 of file bmsparsevec.h.

operator*()

template<class Val , class BV >

back_insert_iterator& bm::sparse_vector< Val, BV >::back_insert_iterator::operator* ( )

inline

noop

Definition at line 312 of file bmsparsevec.h.

operator++() [1/2]

template<class Val , class BV >

back_insert_iterator& bm::sparse_vector< Val, BV >::back_insert_iterator::operator++ ( )

inline

noop

Definition at line 314 of file bmsparsevec.h.

operator++() [2/2]

template<class Val , class BV >

back_insert_iterator& bm::sparse_vector< Val, BV >::back_insert_iterator::operator++ ( int  )

inline

noop

Definition at line 316 of file bmsparsevec.h.

operator=() [1/3]

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::operator= ( back_insert_iterator &&  bi )

inline

move assignment

Definition at line 295 of file bmsparsevec.h.

operator=() [2/3]

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::operator= ( const back_insert_iterator &  bi )

inline

Definition at line 283 of file bmsparsevec.h.

References BM_ASSERT, bm::sparse_vector< Val, BV >::back_insert_iterator::empty(), and bm::sparse_vector< Val, BV >::n_buf_size.

operator=() [3/3]

template<class Val , class BV >

void bm::sparse_vector< Val, BV >::back_insert_iterator::operator= ( value_type  v )

inline

push value to the vector

Definition at line 310 of file bmsparsevec.h.

---

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

• bmsparsevec.h