nightfury7 / universalbasics.js

src/ub.strings.asserts.js

/** global: UB */

var stringFuncs = {
	
	
	// checks
	isAllCaps: function(){
		var str = this;
		return (str.toUpperCase() == str);
	},
	isUppercase: function(){
		var str = this;
		return (str.toUpperCase() == str);
	},
	isLowercase: function(){
		var str = this;
		return (str.toLowerCase() == str);
	},
	isComplexNumber: function(){
		var text = this.toString();
		return text.contains("0x") || text.contains("0X") || text.contains("+e") || text.contains("+E") || text.contains("-e") || text.contains("-E");
	},
	
	isBlank: function(trimAndCheck = true){
		var str = this.toString();
		if (str == "") {
			return true;
		}
		if (trimAndCheck) {
			return str.trim() == "";
		}
		return false;
	},
	isEmpty: function(trimAndCheck = true){
		var str = this.toString();
		return str.isBlank(trimAndCheck);
	},
	isWhitespace: function(newlines){
		var char = this;
		if (newlines) {
			return char == ' ' || char == '\r' || char == '\n' || char == '\t';
		}
		return char == ' ' || char == '\t';
	},
	isNumber: function(){
		var char = this;
		var code = char.charCodeAt(0);
		return (code >= UB.charCodes._0 && code <= UB.charCodes._9);
	},
	isAlphaNumeric: function(){
		var char = this;
		var code = char.charCodeAt(0);
		if (code >= 48 && code <= 57){
			return true;
		}
		if (code >= 65 && code <= 90){
			return true;
		}
		if (code >= 97 && code <= 122){
			return true;
		}
		return false;
	},
	isAlphabet: function(){
		return this.isLetter();
	},
	isLetter: function(){
		var char = this;
		var code = char.charCodeAt(0);
		if (code >= 65 && code <= 90){
			return true;
		}
		if (code >= 97 && code <= 122){
			return true;
		}
		return false;
	},
	isQuote: function(){
		var char = this;
		return (char == '"' || char == "'");
	},
	isMultiline: function(trimAndCheck = true){
		var str = this.toString();
		
		// if the trimmed string has newline chars then is multiline
		if (trimAndCheck) {
			str = str.replace(UB.regex.Trim, "");
		}
		return (str.indexOf("\n") > -1 || str.indexOf("\r") > -1);
	},
	isNewline: function(){
		var str = this;
		
		// if the trimmed string has newline chars then is multiline
		return str == "\n" || str == "\r";
	},
	isSingleline: function(){
		var str = this.toString();
		
		// if the trimmed string has no newline chars then is singleline
		return !str.isMultiline();
	},
	isDigit: function(){
		var ch = this;
		return ( ch >= '0' && ch <= '9' );
	},
	isHexDigit: function(){
		var ch = this;
		return ( (ch >= '0' && ch <= '9') || ( ch >= 'A' && ch <= 'F' ) || ( ch >= 'a' && ch <= 'f' ) );
	},
	isAny: function(haystacks, doTrim = true, caseSensitive = true){
		var needle = this.toString();
		
		// return true if any haystack equals the needle
		for (var s = 0, sl = haystacks.length;s<sl;s++){
			var str = haystacks[s];
			if (doTrim) {
				str = str.trim();
			}
			if (caseSensitive) {
				if (needle == str) {
					return true;
				}
			}else {
				if (needle.isEqual(str, false)) {
					return true;
				}
			}
		}
		return false;
	},
	isNumeric: function(withDot = true, withDash = true){
		var str = this;
		
		// per char
		for (var c = 0, cl = str.length;c<cl;c++){
			var code = str.charCodeAt(c);
			
			// if char not number ... or dot and dot not ok ... or dash and dash not ok
			if (!((code >= UB.charCodes._0 && code <= UB.charCodes._9) || (withDot && code == UB.charCodes.Dot) || (withDash && code == UB.charCodes.Minus && c === 0))) {
				return false;
			}
		}
		
		// if all chars OK then is numeric
		return true;
	},		
	isInt: function(){
		var text = this;
		return String(parseInt(text)) == text;
	},
	isWindowsPath: function(){
		var str = this;
		
		/// c:\temp
		/// D:\My\Data\File.txt
		
		if (str.charAt(1) == ":"){
			if (str.indexOf("\\") == 2) {
				if(str.charAt(0).isAlphaNumeric()){
					return true;
				}
			}
		}
		return false;
	},
	isWindowsPathAll: function(){
		var str = this;
		
		/*
		 * WORKS FOR:
		 * 
		c:\temp
		D:\directoryname\testing\
		\john-desktop\tempdir\
		*/
		
		var c0 = str.charAt(0);
		var c1 = str.charAt(1);
		var c2 = str.charAt(2);
		if(c0 != "\\" || c1 != "\\"){
			if(c0.match(new RegExp("^[a-zA-Z]"))){
				if (c1.match(new RegExp("^[:]"))){
					if (c2.match(new RegExp("^[\\/\\\\]"))) {
						return true;
					}
				}
			}
		}
		return false;
	},
	isURL: function(){
		var str = this;
		if (str.indexOf("/") > -1) {
			return UB.regex.IsURL.test(str);
		}
		return false;
	},
	isEmail: function(){
		var str = this;
		
		// perform quick tests before regex
		var lastAtPos = str.lastIndexOf('@');
		if (lastAtPos === -1) {
			return false;
		}
		var lastDotPos = str.lastIndexOf('.');
		if (lastDotPos === -1) {
			return false;
		}
		
		// Last "@" before last "." since "@" cannot be part of server name
		// something (the email username) before the last @
		// no "@@" in the address. Even if "@" appears as the last character in email username, it has to be quoted so " would be between that "@" and the last "@" in the address
		// at least 3 characters before the last dot, for example "a@b.com"
		// enough characters after the last dot to form a two-character domain
		if ((lastAtPos < lastDotPos && lastAtPos > 0 && str.indexOf('@@') === -1 && lastDotPos > 2 && (str.length - lastDotPos) > 2) == false) {
			return false;
		}
		
		// perform slow regex test
		/// http://stackoverflow.com/a/46181
		return UB.regex.IsEmail.test(str);
	},
	isIPAddress: function(){
		var str = this;
		if (str.indexOf(".") > -1) {
			return UB.regex.IsIP.test(str);
		}
		return false;
	},
	isSymbol: function(){
		var char = this;
		return UB.commonSymbols.indexOf(char) > -1;
	},
	isVariable: function(spaceOk = false){
		var str = this;
		
		// if first char is LETTER..
		if (str.length > 0 && str.charAt(0).isOfCharRange("letter")) {
			
			// ..and other chars are LETTER, DIGIT or "_"
			for (var c = 1, cl = str.length;c<cl;c++){
				var char = str.charAt(c);
				if (char.isDigit() || char.isLetter() || char == "_" || (spaceOk && char == " ")) {

This code block is empty. Consider removing it or adding a comment to explain.

				}else {
					return false;
				}
			}
			return true;
		}
		
		return false;
	},
	
	// counting
	countStartingChars: function(char){
		var str = this;
		for (var c = 0, cl = str.length;c<cl;c++){
			if (str.charAt(c) != char) {
				return c;
			}
		}
		return cl;
	},
	countEndingChars: function(char){
		var str = this;
		var cl = str.length;
		for (var c = cl;c >= 0;c--){
			if (str.charAt(c) != char) {
				return cl - c;
			}
		}
		return cl;
	},
	countStartingUppercase: function(){
		var str = this;
		for (var c = 0, cl = str.length;c<cl;c++){
			if (!str.charAt(c).isUppercase()) {
				return c;
			}
		}
		return 0;
	},
	countStartingLowercase: function(){
		var str = this;
		for (var c = 0, cl = str.length;c<cl;c++){
			if (!str.charAt(c).isLowercase()) {
				return c;
			}
		}
		return 0;
	},
	
	
	none:null
};

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