strsvsample01.cpp

Example of how to use bm::str_sparse_vector<> - succinct container for bit-transposed string collections.

Example of how to use bm::str_sparse_vector<> - succinct container for bit-transposed string collections

See also
  bm::str_sparse_vector

/*
Copyright(c) 2002-2017 Anatoliy Kuznetsov(anatoliy_kuznetsov at yahoo.com)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
For more information please visit: http://bitmagic.io
*/
/** \example strsvsample01.cpp
Example of how to use bm::str_sparse_vector<> - succinct container for
bit-transposed string collections
\sa bm::str_sparse_vector
*/
/*! \file strsvsample01.cpp
\brief Example: str_sparse_vector<> set values, optimize memory
*/
#include <iostream>
#include <string>
#include <vector>
#include <cassert>
#include "bm.h"
#include "bmstrsparsevec.h"
#include "bmundef.h" /* clear the pre-proc defines from BM */
using namespace std;
typedef bm::bvector<> bvector_type;
// define the sparse vector type for 'char' type using bvector as
// a container of bits for bit-transposed planes
// 32 - is maximum string length for this container.
// Memory allocation is dynamic using sparse techniques, so this number
// just defines the max capacity.
//
typedef bm::str_sparse_vector<char, bvector_type, 32> str_sv_type;
int main(void)
{
try
{
str_sv_type str_sv;
const char* s0 = "asz1234";
std::string str1 = "aqw1234";
std::string str3 = "54z";
std::string str00 = "00";
str_sv.set(0, s0); // set a C-string
str_sv.push_back(str1); // add from an STL string
str_sv.assign(3, str3); // assign element 3 from an STL string
// please note that container automatically resizes
std::cout << "sv size()=" << str_sv.size() << endl; // 4
str_sv.insert(0, str00); // insert element
str_sv.erase(0); // erase element 0
// optimize runs compression in all bit-plains
{
BM_DECLARE_TEMP_BLOCK(tb)
str_sv.optimize(tb);
}
// print out the container content using [] reference
//
for (str_sv_type::size_type i = 0; i < str_sv.size(); ++i)
{
const char* s = str_sv[i];
cout << i << ":" << s << endl;
} // for i
cout << "----" << endl;
// print content using const_iterator
//
// const iterator has a bulk implementation,
// not like random access const_iterator is transposing a whole set
// of elements at once, it is faster for bulk traverse
//
{
str_sv_type::const_iterator it = str_sv.begin();
str_sv_type::const_iterator it_end = str_sv.end();
for (; it != it_end; ++it)
{
cout << *it << endl;
} // for it
}
// ---------------------------------------------
str_sv_type str_sv2(bm::use_null); // NULL-able string vector
str_sv2.set(1, "s1");
str_sv2.push_back("s2");
str_sv2.push_back_null();
str_sv2.push_back("s3");
std::string s;
bool found = str_sv2.try_get(0, s); // FALSE (NULL value)
assert(!found); (void)found;
found = str_sv2.try_get(2, s); // TRUE, "s2"
assert(found);
std::cout << s << std::endl;
// print out vector content with NULL check
{
str_sv_type::const_iterator it = str_sv2.begin();
it.go_to(1); // position to idx=1, skipping the element 0
for (; it.valid(); ++it)
{
if (it.is_null())
cout << "NULL, ";
else
cout << *it << ", ";
} // for it.valid()
cout << endl;
}
}
catch(std::exception& ex)
{
std::cerr << ex.what() << std::endl;
return 1;
}
return 0;
}
bm.h
Compressed bit-vector bvector<> container, set algebraic methods, traversal iterators.
BM_DECLARE_TEMP_BLOCK
#define BM_DECLARE_TEMP_BLOCK(x)
Definition bm.h:47
bmstrsparsevec.h
string sparse vector based on bit-transposed matrix
bmundef.h
pre-processor un-defines to avoid global space pollution (internal)
bm::bvector
Bitvector Bit-vector container with runtime compression of bits.
Definition bm.h:115
bm::str_sparse_vector
succinct sparse vector for strings with compression using bit-slicing ( transposition) method
Definition bmstrsparsevec.h:72
bm::str_sparse_vector::insert
void insert(size_type idx, const value_type *str)
insert the specified element
Definition bmstrsparsevec.h:1677
bm::str_sparse_vector::end
const_iterator end() const BMNOEXCEPT
Provide const iterator access to the end.
Definition bmstrsparsevec.h:946
bm::str_sparse_vector::optimize
void optimize(bm::word_t *temp_block=0, typename bvector_type::optmode opt_mode=bvector_type::opt_compress, typename str_sparse_vector< CharType, BV, STR_SIZE >::statistics *stat=0)
run memory optimization for all vector planes
Definition bmstrsparsevec.h:1848
bm::str_sparse_vector::assign
void assign(size_type idx, const StrType &str)
set specified element with bounds checking and automatic resize
Definition bmstrsparsevec.h:648
bm::str_sparse_vector::size
size_type size() const
return size of the vector
Definition bmstrsparsevec.h:857
bm::str_sparse_vector::begin
const_iterator begin() const BMNOEXCEPT
Provide const iterator access to container content.
Definition bmstrsparsevec.h:2589
bm::str_sparse_vector::push_back
void push_back(const StrType &str)
push back a string
Definition bmstrsparsevec.h:683
bm::str_sparse_vector::try_get
bool try_get(size_type idx, StrType &str) const
get specified string element if NOT NULL Template method expects an STL-compatible type basic_string<...
Definition bmstrsparsevec.h:710
bm::str_sparse_vector::erase
void erase(size_type idx)
erase the specified element
Definition bmstrsparsevec.h:1705
bm::str_sparse_vector::push_back_null
void push_back_null(size_type count)
push back specified amount of NULL values
Definition bmstrsparsevec.h:1727
bm::str_sparse_vector::set
void set(size_type idx, const value_type *str)
set specified element with bounds checking and automatic resize
Definition bmstrsparsevec.h:1666
bm::str_sparse_vector< char, bvector_type, 32 >::size_type
bvector_type::size_type size_type
Definition bmstrsparsevec.h:79
bm::use_null
@ use_null
support "non-assigned" or "NULL" logic
Definition bmconst.h:230
main
int main(void)
Definition sample1.cpp:43
str_sv_type
bm::str_sparse_vector< char, bvector_type, 32 > str_sv_type
Definition strsvsample01.cpp:49
bvector_type
bm::bvector bvector_type
Definition xsample07a.cpp:94