// str.js
function isWhitespace( c )
{
   var whitespaceChars = " \t\n\r\f";
   return ( whitespaceChars.indexOf(c) != -1 );
}
function ltrim( s )
{ 
   for( var k = 0; k < s.length && isWhitespace( s.charAt(k) ); k++ );
   return s.substring( k, s.length );
}
function rtrim( s )
{
   for( var j = s.length-1; j>=0 && isWhitespace( s.charAt(j) ) ; j-- );
   return s.substring( 0, j+1 );
}
function trimStr( s )      { return( ltrim( rtrim(s) ) ); }
function isEmptyStr( s )   { return( s == '' ); }
function isValidStr( s )   { return( s != '' ); }
function isInStr( s, c )   { return( s.indexOf(c) != -1 ); }
function joinStr( a, s, b ){ return( (isValidStr(a) && isValidStr(b)) ? a + s + b : a + b ); }

function alertEmptyStr( vsStr, vsMsg )
{  
   var b = isEmptyStr( vsStr );
   if( b ) { alert( vsMsg ); }
   return( b );
}

function alertErrorStr( vsMsg )
{  
   alert( vsMsg );
   return( false );
}