//String functions and methods

// method .trim()  -  remove leading spaces, trailing spaces, and consecutive spaces
// method .ltrim()  -  remove leading spaces
// method .rtrim()  -  remove trailing spaces
// method .left(n) - remove all but left most n characters
// method .right(n) - remove leading characters until only n remain

String.prototype.trim	= function(){return (this.replace(/(^ +)|( +$)/g,'')).replace(/( +)/g,' ')};
String.prototype.ltrim	= function(){return this.replace(/(^ +)/g,'')};
String.prototype.rtrim	= function(){return this.replace(/( +$)/g,'')};
String.prototype.right	= function(n){return this.substr(this.length - n)};
String.prototype.left	= function(n){return this.substring(0,n)};



// function trim(stringVar)  returns stringVar.trim()
// function ltrim(stringVar)  returns stringVar.ltrim()
// function rtrim(stringVar)  returns stringVar.rtrim()
// function left(stringVar,n)  returns stringVar.left(n)
// function right(stringVar,n)  returns stringVar.right(n)
// function replace( source, target, replacement )  returns string where instances target are replaced by replacement


function trim(stringVar) { return( stringVar.trim() ); }
function ltrim(stringVar) { return( stringVar.ltrim() ); }
function rtrim(stringVar) { return( stringVar.rtrim() ); }
function left(stringVar,n) { return( stringVar.left(n) ); }
function right(stringVar,n) { return( stringVar.right(n) ); }
function replace( sourceVar, targetVar, replaceVar ) { return sourceVar.replace(targetVar,replaceVar); }