#include "vstring.h"
#include "vstrlib.h"

VString str = "Hello";
str += " World";    // str is `Hello World' now
str_reverse( str ); // str is `dlroW olleH' now
str_low( str );     // lower case

VArray va = str_split( " +", str ); // array has `dlroW', `olleH'
                                    // " +" is Regexp
str_reverse( va[0] );
str_reverse( va[1] );

str = str_join( va, " " );  // str is back to "Hello World"

VTrie tr = va;

// tr[ "Hello" ] contains "World"

str_set( str, "hello" );
str_mul( str, 4 );
str_replace( str, "o", " " );
str_left( dest_str, str, 4 );
str_up( dest_str );

VString str = "hello";
str += " world";
if( str == "hello world") { ... }
int len = str_len( str );
str[3] = 'z'; // safe! even outside string boundaries

VArray va;

// append array elements
va.push( "element 1" );
va.push( str ); // i.e. VString
va.push( other_varray ); 
va.push( trie ); // see VTrie below

// take out the last element
VString str = va.pop()

// push elements at the beginning 
va.unshift( "element 1" );
va.unshift( str ); // i.e. VString
va.unshift( other_varray ); 
va.unshift( trie ); // see VTrie below

// take out the first element
VString str = va.shift();

va.reverse(); // reverse elements order
va.undef(); // remove all elements

VTrie tr;

tr[ "hello"  ] = "world";
tr[ "number" ] = "12345";

VArray va = tr; // array is: hello world number 12345
                // however only key+value order is preserved!

tr.reverse(); // reverse keys <-> values
                
tr.undef(); // remove all keys

VRegexp re( "a([0-9]+)" ); // compiling new regexp

if( re.m( "tralala85." ) ) // match against compiled regexp
  res1 = re[1]; // re[1] returns `85'

if( re.m( "tralala85.", "(la)+" ) ) // match against new regexp pattern
  {
  str_all_matched   = re[0]; // `lala'
  str_first_capture = re[1]; // `la'
  }