Namespace: fnNumberStringUtil

The fnNumberStringUtil namespace provides functions for working with numbers in String format.

To use this API alone by itself, include fnNumberStringUtil.js. Otherwise, include faiNumber-include-all.js.

This namespace provide functions for validating strings to see whether if they are valid number and for comparing strings of number.

This namespace has the assume**** functions, of which operate on strings with the assumption that the strings are valid number values. For comparing string of numbers there are the assumeCompare**** functions.

Under the right circumstance, the assume**** functions are very powerful and fast functions. However, under that use case, the strings must be valid number strings for the functions to produce the correct result. Thus, the assume**** functions of this namespace are good for circumstances where the input data have been validated before usage and there isn't a need for revalidating the data.

For an example of one of the assume**** function of this namespace API, the assumeCompare function of this namespace API besides being able to compare numbers, it can also compare dates with fix format. Format like YYYY-MM-DD, YYYY/MM/DD, or similar can be compared. However, for correct results, the month, day, or year value must consistenly be in the same amount of digits(i.e. year 500 and 2000 have to be written as 0500 and 1000, or month 1 and 12 have to be written as 01 and 12). Also, year always have to be first, then month, then finally day.

Example usage of the assumeCompare function.

var a = "1208925819614629174706176";
var b = "1208925819614629174706177";
console.log(fnNumberStringUtil.assumeCompare(a,b));

var d1 = "2018-01-23";
var d2 = "2018-12-24";
console.log(fnNumberStringUtil.assumeCompare(d1,d2));

var d3 = "2018-12-24";
var d4 = "2018-12-03";
console.log(fnNumberStringUtil.assumeCompare(d3,d4));

For comparing strings of numbers, besides the assumeCompare or the assumeCompareAllBase function, this namespace API also provide the compare and the compareAsBase function for comparing strings of number where there is a need to validate the strings when comparing.

For speed-wise, the assumeCompare**** and compare**** functions of this namespace API excel in circumstance where the strings do not have to be compared up until the last digit to know which string is larger or smaller.

Another advantage of the compare**** and assumeCompare**** functions is that, there isn't a upper bound on the length of the input strings. That is as long as memory allow.