nightfury7 / universalbasics.js

src/ub.strings.findAndReplace.js

/** global: UB */

var stringFuncs = {
	
	replaceAllCI: function(find, replace){
		return this.replaceAll(find, replace, false, false);
	},
	replaceAll: function(find, replace, wholeWords = false, caseSensitive = true){
		var s = this.toString();
		
		// find and replace given term
		if (wholeWords || !caseSensitive) {
			var regex = UB.regex.New(find, wholeWords, caseSensitive, true);
			s = s.replace(regex, replace);
		}else {
			if (s.indexOf(find) > -1) {
				return s.split(find).join(replace);
			}
		}
		return s;
	},
	replaceOnce: function(find, replace, wholeWords = false, caseSensitive = true){
		var s = this.toString();
		var regex = UB.regex.New(find, wholeWords, caseSensitive, false);
		if (s.match(regex) != null){
			s = s.replace(regex, replace);
		}
		return s;
	},
	replaceBetween: function(findStart, findEnd, replaceWith, keepEnds = true, startAt = 0, times = 0){
		var s = this.toString();
		
		var start;
		var last = 0;
		var done = 0;
		
		if ((start = s.indexOf(findStart)) > -1){
			
			// for each instance of marker
			while (true) {
				
				// exit if end marker not in text
				var end = s.indexOf(findEnd, start + findStart.length);
				if (end === -1) {
					return s;
				}
				
				// get code before/after markers
				var partA = s.substr(0, start);
				var partB = s.substr(end + findEnd.length);
				
				// merge code with new value inplace of markers
				if (keepEnds) {
					s = partA + findStart + replaceWith + findEnd;
				}else {
					s = partA + replaceWith;
				}
				
				// move forward
				last = s.length;
				
				// add ending text
				s += partB;
				
				// find next marker
				start = s.indexOf(findStart, last);
				if (start === -1) {
					break;
				}
				
				// only replace certain number of times
				done++;
				if (done == times) { /// ignore "times" if 0
					break;
				}
			}
			
		}
		return s;
	},
	replaceMany: function(findArray, replaceArray, wholeWords = false, caseSensitive = true){
		var result = this.toString();
		if (findArray.length != replaceArray.length){
			return result;
		}
		// find and replace each term
		for (var f = 0, fl = findArray.length;f<fl;f++){
			if (!caseSensitive || result.indexOf(findArray[f]) > -1) {
				result = result.replaceAll(findArray[f], replaceArray[f], wholeWords, caseSensitive);
			}
		}
		return result;
	},
	replaceManyObj: function(findReplace, wholeWords = false, caseSensitive = true){
		var result = this.toString();
		
		for (var ft in findReplace){

A for in loop automatically includes the property of any prototype object, consider checking the key using hasOwnProperty.

			var rt = findReplace[ft];
			
			if (!caseSensitive || result.indexOf(ft) > -1) {
				
				result = result.replaceAll(ft, rt, wholeWords, caseSensitive);
				
			}
			
		}
		
		return result;
	},
	replaceManyWithOne: function(findArray, replace, wholeWords = false, caseSensitive = true){
		var s = this.toString();
		
		// find and replace each term
		for (var f = 0, fl = findArray.length;f<fl;f++){
			s = s.replaceAll(findArray[f], replace, wholeWords, caseSensitive);
		}
		return s;
	},
	replaceTimes: function(find, replaceWith, startAt = 0, forward = true, times = 0){
		var s = this.toString();
		
		var start;
		var last = startAt;
		var done = 0;
		
		// how long is the replaced string
		var len = replaceWith.length;
		
		// for each instance of marker
		while ((start = forward ? s.indexOf(find, last) : s.lastIndexOf(find, last)) > -1) {
			
			// get code before/after markers
			var partA = s.substr(0, start);
			var partB = s.substr(s.indexOf(find, start) + find.length);
			
			// merge code with new value inplace of markers
			s = partA + replaceWith + partB;
			
			// move forward/backward
			last = start + (forward ? len : -1);
			
			
			// only replace certain number of times
			done++;
			if (done == times) { /// ignore "times" if 0
				break;
			}
		}
		return s;
	},
	
	
	/** Checks if the prefix is `oldPrefix`, and replaces with `newPrefix` if it is.
		Does NOT replace chars in the prefix! Replaces the ENTIRE prefix instead! */
	replacePrefix: function(oldPrefix, newPrefix, caseSensitive = true){
		var str = this;
		if (str.startsWith(oldPrefix, caseSensitive)) {
			return newPrefix + str.substr(oldPrefix.length);
		}
		return str;
	},
	/** Checks if the prefix is `oldPrefix`, and replaces with `newPrefix` if it is.
		Does NOT replace chars in the prefix! Replaces the ENTIRE prefix instead! */
	replacePostfix: function(oldPostfix, newPostfix, caseSensitive = true){
		var str = this;
		if (str.endsWith(oldPostfix, caseSensitive)) {
			return str.substr(0, str.length - oldPostfix.length) + newPostfix;
		}
		return str;
	},
	
	none:null
};

// register funcs
UB.registerFuncs(String.prototype, stringFuncs);