/**
* @depends nothing
* @name core.string
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
*/
/**
* Return a new string with any spaces trimmed the left and right of the string
* @version 1.0.0
* @date June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.trim = String.prototype.trim || function() {
// Trim off any whitespace from the front and back
return this.replace(/^\s+|\s+$/g, '');
};
/**
* Return a new string with the value stripped from the left and right of the string
* @version 1.1.1
* @date July 22, 2010
* @since 1.0.0, June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.strip = String.prototype.strip || function(value,regex){
// Strip a value from left and right, with optional regex support (defaults to false)
value = String(value);
var str = this;
if ( value.length ) {
if ( !(regex||false) ) {
// We must escape value as we do not want regex support
value = value.replace(/([\[\]\(\)\^\$\.\?\|\/\\])/g, '\\$1');
}
str = str.replace(eval('/^'+value+'+|'+value+'+$/g'), '');
}
return String(str);
}
/**
* Return a new string with the value stripped from the left of the string
* @version 1.1.1
* @date July 22, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.stripLeft = String.prototype.stripLeft || function(value,regex){
// Strip a value from the left, with optional regex support (defaults to false)
value = String(value);
var str = this;
if ( value.length ) {
if ( !(regex||false) ) {
// We must escape value as we do not want regex support
value = value.replace(/([\[\]\(\)\^\$\.\?\|\/\\])/g, '\\$1');
}
str = str.replace(eval('/^'+value+'+/g'), '');
}
return String(str);
}
/**
* Return a new string with the value stripped from the right of the string
* @version 1.1.1
* @date July 22, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.stripRight = String.prototype.stripRight || function(value,regex){
// Strip a value from the right, with optional regex support (defaults to false)
value = String(value);
var str = this;
if ( value.length ) {
if ( !(regex||false) ) {
// We must escape value as we do not want regex support
value = value.replace(/([\[\]\(\)\^\$\.\?\|\/\\])/g, '\\$1');
}
str = str.replace(eval('/'+value+'+$/g'), '');
}
return String(str);
}
/**
* Return a int of the string
* @version 1.0.0
* @date June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.toInt = String.prototype.toInt || function(){
// Convert to a Integer
return parseInt(this,10);
};
/**
* Return a new string of the old string wrapped with the start and end values
* @version 1.0.0
* @date June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.wrap = String.prototype.wrap || function(start,end){
// Wrap the string
return start+this+end;
};
/**
* Return a new string of a selection of the old string wrapped with the start and end values
* @version 1.0.0
* @date June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.wrapSelection = String.prototype.wrapSelection || function(start,end,a,z){
// Wrap the selection
if ( typeof a === 'undefined' || a === null ) a = this.length;
if ( typeof z === 'undefined' || z === null ) z = this.length;
return this.substring(0,a)+start+this.substring(a,z)+end+this.substring(z);
};
/**
* Return a new string of the slug of the old string
* @version 1.1.0
* @date July 16, 2010
* @since 1.0.0, June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.toSlug = String.prototype.toSlug || function(){
// Convert a string to a slug
return this.toLowerCase().replace(/[\s_]/g, '-').replace(/[^-a-z0-9]/g, '').replace(/--+/g, '-').replace(/^-+|-+$/g,'');
}
/**
* Return a new JSON object of the old string.
* Turns:
* file.js?a=1&b.c=3.0&b.d=four&a_false_value=false&a_null_value=null
* Into:
* {"a":1,"b":{"c":3,"d":"four"},"a_false_value":false,"a_null_value":null}
* @version 1.1.0
* @date July 16, 2010
* @since 1.0.0, June 30, 2010
* @package jquery-sparkle {@link http://www.balupton/projects/jquery-sparkle}
* @author Benjamin "balupton" Lupton {@link http://www.balupton.com}
* @copyright (c) 2009-2010 Benjamin Arthur Lupton {@link http://www.balupton.com}
* @license GNU Affero General Public License version 3 {@link http://www.gnu.org/licenses/agpl-3.0.html}
*/
String.prototype.queryStringToJSON = String.prototype.queryStringToJSON || function ( )
{ // Turns a params string or url into an array of params
// Prepare
var params = String(this);
// Remove url if need be
params = params.substring(params.indexOf('?')+1);
// params = params.substring(params.indexOf('#')+1);
// Change + to %20, the %20 is fixed up later with the decode
params = params.replace(/\+/g, '%20');
// Do we have JSON string
if ( params.substring(0,1) === '{' && params.substring(params.length-1) === '}' )
{ // We have a JSON string
return eval(decodeURIComponent(params));
}
// We have a params string
params = params.split(/\&(amp\;)?/);
var json = {};
// We have params
for ( var i = 0, n = params.length; i < n; ++i )
{
// Adjust
var param = params[i] || null;
if ( param === null ) { continue; }
param = param.split('=');
if ( param === null ) { continue; }
// ^ We now have "var=blah" into ["var","blah"]
// Get
var key = param[0] || null;
if ( key === null ) { continue; }
if ( typeof param[1] === 'undefined' ) { continue; }
var value = param[1];
// ^ We now have the parts
// Fix
key = decodeURIComponent(key);
value = decodeURIComponent(value);
try {
// value can be converted
value = eval(value);
} catch ( e ) {
// value is a normal string
}
// Set
// window.console.log({'key':key,'value':value}, split);
var keys = key.split('.');
if ( keys.length === 1 )
{ // Simple
json[key] = value;
}
else
{ // Advanced (Recreating an object)
var path = '',
cmd = '';
// Ensure Path Exists
$.each(keys,function(ii,key){
path += '["'+key.replace(/"/g,'\\"')+'"]';
jsonCLOSUREGLOBAL = json; // we have made this a global as closure compiler struggles with evals
cmd = 'if ( typeof jsonCLOSUREGLOBAL'+path+' === "undefined" ) jsonCLOSUREGLOBAL'+path+' = {}';
eval(cmd);
json = jsonCLOSUREGLOBAL;
delete jsonCLOSUREGLOBAL;
});
// Apply Value
jsonCLOSUREGLOBAL = json; // we have made this a global as closure compiler struggles with evals
valueCLOSUREGLOBAL = value; // we have made this a global as closure compiler struggles with evals
cmd = 'jsonCLOSUREGLOBAL'+path+' = valueCLOSUREGLOBAL';
eval(cmd);
json = jsonCLOSUREGLOBAL;
delete jsonCLOSUREGLOBAL;
delete valueCLOSUREGLOBAL;
}
// ^ We now have the parts added to your JSON object
}
return json;
};
