necessary 17.1.7 → 17.1.10

package/README.md

@@ -824,7 +824,7 @@ If the array is not long enough they return `undefined`.
   
 * The `head()` function returns an array containing the first element of its array argument whilst the `tail()` function returns an array containing all but the first element of its array argument. 
  
-* The `back()` function returns an array containing hte last element of its array argument whilst the `front()` function returns an array returning all but the last element of its array argument.
+* The `back()` function returns an array containing the last element of its array argument whilst the `front()` function returns an array returning all but the last element of its array argument.
 
 * The `push()` function is similar to its native counterpart but will push an array rather than a single element.
 
@@ -1091,19 +1091,19 @@ Its return value is the difference between the code points of the first differin
 Some examples should clarify:
 
 ```
-strcmp("", "") = 0;
+strcmp("", "") === 0;
 
-strcmp("a", "") < 0;
+strcmp("a", "") > 0;
 
-strcmp("", "a") > 0;
+strcmp("", "a") < 0;
 
-strcmp("a", "a") = 0;
+strcmp("a", "a") === 0;
 
-strcmp("ab", "a") < 0;
+strcmp("ab", "a") > 0;
 
-strcmp("ab", "ac") > 0;
+strcmp("ab", "ac") < 0;
 
-strcmp("C", "𝔸") > 0;
+strcmp("C", "𝔸") < 0;
 ```
 
 Note that, conceptually speaking, the first argument is taken away from the second argument in order to compute the difference and not the other way around.

package/lib/utilities/string.js

@@ -25,76 +25,67 @@ _export(exports, {
         return substring;
     }
 });
-const _constants = require("../constants");
 function strlen(string) {
     let length = 0;
-    const iterator = string[Symbol.iterator]();
-    let character = iterator.next();
-    while(!character.done){
-        character = iterator.next();
+    for (const _ of string){
         length++;
     }
     return length;
 }
 function strcmp(stringA, stringB) {
-    let difference;
-    const iteratorA = stringA[Symbol.iterator](), iteratorB = stringB[Symbol.iterator](); ///
-    let characterA = iteratorA.next(), characterB = iteratorB.next(), codePointA, codePointB;
-    while(true){
-        codePointA = characterA.value ? characterA.value.codePointAt(0) : 0;
-        codePointB = characterB.value ? characterB.value.codePointAt(0) : 0;
-        difference = codePointB - codePointA;
+    let difference = 0;
+    let naiveIndexA = 0, naiveIndexB = 0;
+    const stringANaiveLength = stringA.length, stringBNaiveLength = stringB.length;
+    while(naiveIndexA < stringANaiveLength || naiveIndexB < stringBNaiveLength){
+        const codePointA = naiveIndexA < stringANaiveLength ? stringA.codePointAt(naiveIndexA) : 0, codePointB = naiveIndexB < stringBNaiveLength ? stringB.codePointAt(naiveIndexB) : 0;
+        difference = codePointA - codePointB;
         if (difference !== 0) {
             break;
         }
-        if (characterA.done || characterB.done) {
-            break;
-        }
-        characterA = iteratorA.next();
-        characterB = iteratorB.next();
+        naiveIndexA += codePointA > 0xFFFF ? 2 : 1;
+        naiveIndexB += codePointB > 0xFFFF ? 2 : 1;
     }
     return difference;
 }
 function indexOf(string, searchString) {
-    let index = -1, found = false;
-    const searchStringLength = strlen(searchString);
+    let index = -1;
+    const searchStringLength = searchString.length;
     if (searchStringLength > 0) {
-        let character;
-        const iterator = string[Symbol.iterator](), searchIterator = searchString[Symbol.iterator](), searchCharacter = searchIterator.next();
-        character = iterator.next();
-        index++;
-        while(!character.done){
-            if (character.value === searchCharacter.value) {
-                const start = index, end = start + searchStringLength, subString = substring(string, start, end), difference = strcmp(subString, searchString);
-                if (difference === 0) {
-                    found = true;
-                    break;
-                }
+        const outerNaiveIndex = string.indexOf(searchString);
+        if (outerNaiveIndex > -1) {
+            index = 0;
+            let innerNaiveIndex = 0;
+            while(innerNaiveIndex < outerNaiveIndex){
+                const charCode = string.charCodeAt(innerNaiveIndex);
+                innerNaiveIndex += charCode >= 0xD800 && charCode <= 0xDBFF ? 2 : 1;
+                index++;
             }
-            character = iterator.next();
-            index++;
         }
     }
-    if (!found) {
-        index = -1;
-    }
     return index;
 }
 function substring(string, start, end = Infinity) {
-    let index = 0;
-    const iterator = string[Symbol.iterator](), characters = [];
-    let character = iterator.next();
-    while(!character.done){
+    const stringNaiveLength = string.length;
+    let index = 0, naiveIndex = 0, naiveStart = stringNaiveLength, naiveEnd = stringNaiveLength; ///
+    while(naiveIndex < stringNaiveLength){
+        if (index === start) {
+            naiveStart = naiveIndex; ///
+        }
         if (index === end) {
+            naiveEnd = naiveIndex; ///
             break;
         }
-        if (index >= start) {
-            characters.push(character.value); ///
-        }
+        const charCode = string.charCodeAt(naiveIndex);
+        naiveIndex += charCode >= 0xD800 && charCode <= 0xDBFF ? 2 : 1;
         index++;
-        character = iterator.next();
     }
-    const substring1 = characters.join(_constants.EMPTY_STRING);
+    if (index === start) {
+        naiveStart = naiveIndex; ///
+    }
+    if (index === end) {
+        naiveEnd = naiveIndex; ///
+    }
+    const substring1 = string.substring(naiveStart, naiveEnd);
     return substring1;
 }
 const _default = {
@@ -104,4 +95,4 @@ const _default = {
     substring
 };
 
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlsaXRpZXMvc3RyaW5nLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5pbXBvcnQgeyBFTVBUWV9TVFJJTkcgfSBmcm9tIFwiLi4vY29uc3RhbnRzXCI7XG5cbmV4cG9ydCBmdW5jdGlvbiBzdHJsZW4oc3RyaW5nKSB7XG4gIGxldCBsZW5ndGggPSAwO1xuXG4gIGNvbnN0IGl0ZXJhdG9yID0gc3RyaW5nW1N5bWJvbC5pdGVyYXRvcl0oKTtcblxuICBsZXQgY2hhcmFjdGVyID0gaXRlcmF0b3IubmV4dCgpO1xuXG4gIHdoaWxlICghY2hhcmFjdGVyLmRvbmUpIHtcbiAgICBjaGFyYWN0ZXIgPSBpdGVyYXRvci5uZXh0KCk7XG5cbiAgICBsZW5ndGgrK1xuICB9XG5cbiAgcmV0dXJuIGxlbmd0aDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHN0cmNtcChzdHJpbmdBLCBzdHJpbmdCKSB7XG4gIGxldCBkaWZmZXJlbmNlO1xuXG4gIGNvbnN0IGl0ZXJhdG9yQSA9IHN0cmluZ0FbU3ltYm9sLml0ZXJhdG9yXSgpLCAvLy9cbiAgICAgICAgaXRlcmF0b3JCID0gc3RyaW5nQltTeW1ib2wuaXRlcmF0b3JdKCk7IC8vL1xuXG4gIGxldCBjaGFyYWN0ZXJBID0gaXRlcmF0b3JBLm5leHQoKSxcbiAgICAgIGNoYXJhY3RlckIgPSBpdGVyYXRvckIubmV4dCgpLFxuICAgICAgY29kZVBvaW50QSxcbiAgICAgIGNvZGVQb2ludEI7XG5cbiAgd2hpbGUgKHRydWUpIHtcbiAgICBjb2RlUG9pbnRBID0gY2hhcmFjdGVyQS52YWx1ZSA/IC8vL1xuICAgICAgICAgICAgICAgICAgIGNoYXJhY3RlckEudmFsdWUuY29kZVBvaW50QXQoMCkgOlxuICAgICAgICAgICAgICAgICAgICAgMDtcbiAgICBjb2RlUG9pbnRCID0gY2hhcmFjdGVyQi52YWx1ZSA/IC8vL1xuICAgICAgICAgICAgICAgICAgIGNoYXJhY3RlckIudmFsdWUuY29kZVBvaW50QXQoMCkgOlxuICAgICAgICAgICAgICAgICAgICAgMDtcblxuICAgIGRpZmZlcmVuY2UgPSBjb2RlUG9pbnRCIC0gY29kZVBvaW50QTtcblxuICAgIGlmIChkaWZmZXJlbmNlICE9PSAwKSB7XG4gICAgICBicmVhaztcbiAgICB9XG5cbiAgICBpZiAoY2hhcmFjdGVyQS5kb25lIHx8IGNoYXJhY3RlckIuZG9uZSkge1xuICAgICAgYnJlYWs7XG4gICAgfVxuXG4gICAgY2hhcmFjdGVyQSA9IGl0ZXJhdG9yQS5uZXh0KCk7XG4gICAgY2hhcmFjdGVyQiA9IGl0ZXJhdG9yQi5uZXh0KCk7XG4gIH1cblxuICByZXR1cm4gZGlmZmVyZW5jZTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGluZGV4T2Yoc3RyaW5nLCBzZWFyY2hTdHJpbmcpIHtcbiAgbGV0IGluZGV4ID0gLTEsXG4gICAgICBmb3VuZCA9IGZhbHNlO1xuXG4gIGNvbnN0IHNlYXJjaFN0cmluZ0xlbmd0aCA9IHN0cmxlbihzZWFyY2hTdHJpbmcpO1xuXG4gIGlmIChzZWFyY2hTdHJpbmdMZW5ndGggPiAwKSB7XG4gICAgbGV0IGNoYXJhY3RlcjtcblxuICAgIGNvbnN0IGl0ZXJhdG9yID0gc3RyaW5nW1N5bWJvbC5pdGVyYXRvcl0oKSxcbiAgICAgICAgICBzZWFyY2hJdGVyYXRvciA9IHNlYXJjaFN0cmluZ1tTeW1ib2wuaXRlcmF0b3JdKCksXG4gICAgICAgICAgc2VhcmNoQ2hhcmFjdGVyID0gc2VhcmNoSXRlcmF0b3IubmV4dCgpO1xuXG4gICAgY2hhcmFjdGVyID0gaXRlcmF0b3IubmV4dCgpO1xuXG4gICAgaW5kZXgrKztcblxuICAgIHdoaWxlICghY2hhcmFjdGVyLmRvbmUpIHtcbiAgICAgIGlmIChjaGFyYWN0ZXIudmFsdWUgPT09IHNlYXJjaENoYXJhY3Rlci52YWx1ZSkge1xuICAgICAgICBjb25zdCBzdGFydCA9IGluZGV4LCAgLy8vXG4gICAgICAgICAgICAgIGVuZCA9IHN0YXJ0ICsgc2VhcmNoU3RyaW5nTGVuZ3RoLFxuICAgICAgICAgICAgICBzdWJTdHJpbmcgPSBzdWJzdHJpbmcoc3RyaW5nLCBzdGFydCwgZW5kKSxcbiAgICAgICAgICAgICAgZGlmZmVyZW5jZSA9IHN0cmNtcChzdWJTdHJpbmcsIHNlYXJjaFN0cmluZyk7XG5cbiAgICAgICAgaWYgKGRpZmZlcmVuY2UgPT09IDApIHtcbiAgICAgICAgICBmb3VuZCA9IHRydWU7XG5cbiAgICAgICAgICBicmVhaztcbiAgICAgICAgfVxuICAgICAgfVxuXG4gICAgICBjaGFyYWN0ZXIgPSBpdGVyYXRvci5uZXh0KCk7XG5cbiAgICAgIGluZGV4KytcbiAgICB9XG4gIH1cblxuICBpZiAoIWZvdW5kKSB7XG4gICAgaW5kZXggPSAtMTtcbiAgfVxuXG4gIHJldHVybiBpbmRleDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHN1YnN0cmluZyhzdHJpbmcsIHN0YXJ0LCBlbmQgPSBJbmZpbml0eSkge1xuICBsZXQgaW5kZXggPSAwO1xuXG4gIGNvbnN0IGl0ZXJhdG9yID0gc3RyaW5nW1N5bWJvbC5pdGVyYXRvcl0oKSxcbiAgICAgICAgY2hhcmFjdGVycyA9IFtdO1xuXG4gIGxldCBjaGFyYWN0ZXIgPSBpdGVyYXRvci5uZXh0KCk7XG5cbiAgd2hpbGUgKCFjaGFyYWN0ZXIuZG9uZSkge1xuICAgIGlmIChpbmRleCA9PT0gZW5kKSB7XG4gICAgICBicmVhaztcbiAgICB9XG5cbiAgICBpZiAoaW5kZXggPj0gc3RhcnQpIHtcbiAgICAgIGNoYXJhY3RlcnMucHVzaChjaGFyYWN0ZXIudmFsdWUpOyAvLy9cbiAgICB9XG5cbiAgICBpbmRleCsrXG5cbiAgICBjaGFyYWN0ZXIgPSBpdGVyYXRvci5uZXh0KCk7XG4gIH1cblxuICBjb25zdCBzdWJzdHJpbmcgPSBjaGFyYWN0ZXJzLmpvaW4oRU1QVFlfU1RSSU5HKTtcblxuICByZXR1cm4gc3Vic3RyaW5nO1xufVxuXG5leHBvcnQgZGVmYXVsdCB7XG4gIHN0cmNtcCxcbiAgc3RybGVuLFxuICBpbmRleE9mLFxuICBzdWJzdHJpbmdcbn07XG4iXSwibmFtZXMiOlsiaW5kZXhPZiIsInN0cmNtcCIsInN0cmxlbiIsInN1YnN0cmluZyIsInN0cmluZyIsImxlbmd0aCIsIml0ZXJhdG9yIiwiU3ltYm9sIiwiY2hhcmFjdGVyIiwibmV4dCIsImRvbmUiLCJzdHJpbmdBIiwic3RyaW5nQiIsImRpZmZlcmVuY2UiLCJpdGVyYXRvckEiLCJpdGVyYXRvckIiLCJjaGFyYWN0ZXJBIiwiY2hhcmFjdGVyQiIsImNvZGVQb2ludEEiLCJjb2RlUG9pbnRCIiwidmFsdWUiLCJjb2RlUG9pbnRBdCIsInNlYXJjaFN0cmluZyIsImluZGV4IiwiZm91bmQiLCJzZWFyY2hTdHJpbmdMZW5ndGgiLCJzZWFyY2hJdGVyYXRvciIsInNlYXJjaENoYXJhY3RlciIsInN0YXJ0IiwiZW5kIiwic3ViU3RyaW5nIiwiSW5maW5pdHkiLCJjaGFyYWN0ZXJzIiwicHVzaCIsImpvaW4iLCJFTVBUWV9TVFJJTkciXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7OztRQStIQTtlQUFBOztRQXZFZ0JBO2VBQUFBOztRQXBDQUM7ZUFBQUE7O1FBaEJBQztlQUFBQTs7UUFnR0FDO2VBQUFBOzs7MkJBbEdhO0FBRXRCLFNBQVNELE9BQU9FLE1BQU07SUFDM0IsSUFBSUMsU0FBUztJQUViLE1BQU1DLFdBQVdGLE1BQU0sQ0FBQ0csT0FBT0QsUUFBUSxDQUFDO0lBRXhDLElBQUlFLFlBQVlGLFNBQVNHLElBQUk7SUFFN0IsTUFBTyxDQUFDRCxVQUFVRSxJQUFJLENBQUU7UUFDdEJGLFlBQVlGLFNBQVNHLElBQUk7UUFFekJKO0lBQ0Y7SUFFQSxPQUFPQTtBQUNUO0FBRU8sU0FBU0osT0FBT1UsT0FBTyxFQUFFQyxPQUFPO0lBQ3JDLElBQUlDO0lBRUosTUFBTUMsWUFBWUgsT0FBTyxDQUFDSixPQUFPRCxRQUFRLENBQUMsSUFDcENTLFlBQVlILE9BQU8sQ0FBQ0wsT0FBT0QsUUFBUSxDQUFDLElBQUksR0FBRztJQUVqRCxJQUFJVSxhQUFhRixVQUFVTCxJQUFJLElBQzNCUSxhQUFhRixVQUFVTixJQUFJLElBQzNCUyxZQUNBQztJQUVKLE1BQU8sS0FBTTtRQUNYRCxhQUFhRixXQUFXSSxLQUFLLEdBQ2RKLFdBQVdJLEtBQUssQ0FBQ0MsV0FBVyxDQUFDLEtBQzNCO1FBQ2pCRixhQUFhRixXQUFXRyxLQUFLLEdBQ2RILFdBQVdHLEtBQUssQ0FBQ0MsV0FBVyxDQUFDLEtBQzNCO1FBRWpCUixhQUFhTSxhQUFhRDtRQUUxQixJQUFJTCxlQUFlLEdBQUc7WUFDcEI7UUFDRjtRQUVBLElBQUlHLFdBQVdOLElBQUksSUFBSU8sV0FBV1AsSUFBSSxFQUFFO1lBQ3RDO1FBQ0Y7UUFFQU0sYUFBYUYsVUFBVUwsSUFBSTtRQUMzQlEsYUFBYUYsVUFBVU4sSUFBSTtJQUM3QjtJQUVBLE9BQU9JO0FBQ1Q7QUFFTyxTQUFTYixRQUFRSSxNQUFNLEVBQUVrQixZQUFZO0lBQzFDLElBQUlDLFFBQVEsQ0FBQyxHQUNUQyxRQUFRO0lBRVosTUFBTUMscUJBQXFCdkIsT0FBT29CO0lBRWxDLElBQUlHLHFCQUFxQixHQUFHO1FBQzFCLElBQUlqQjtRQUVKLE1BQU1GLFdBQVdGLE1BQU0sQ0FBQ0csT0FBT0QsUUFBUSxDQUFDLElBQ2xDb0IsaUJBQWlCSixZQUFZLENBQUNmLE9BQU9ELFFBQVEsQ0FBQyxJQUM5Q3FCLGtCQUFrQkQsZUFBZWpCLElBQUk7UUFFM0NELFlBQVlGLFNBQVNHLElBQUk7UUFFekJjO1FBRUEsTUFBTyxDQUFDZixVQUFVRSxJQUFJLENBQUU7WUFDdEIsSUFBSUYsVUFBVVksS0FBSyxLQUFLTyxnQkFBZ0JQLEtBQUssRUFBRTtnQkFDN0MsTUFBTVEsUUFBUUwsT0FDUk0sTUFBTUQsUUFBUUgsb0JBQ2RLLFlBQVkzQixVQUFVQyxRQUFRd0IsT0FBT0MsTUFDckNoQixhQUFhWixPQUFPNkIsV0FBV1I7Z0JBRXJDLElBQUlULGVBQWUsR0FBRztvQkFDcEJXLFFBQVE7b0JBRVI7Z0JBQ0Y7WUFDRjtZQUVBaEIsWUFBWUYsU0FBU0csSUFBSTtZQUV6QmM7UUFDRjtJQUNGO0lBRUEsSUFBSSxDQUFDQyxPQUFPO1FBQ1ZELFFBQVEsQ0FBQztJQUNYO0lBRUEsT0FBT0E7QUFDVDtBQUVPLFNBQVNwQixVQUFVQyxNQUFNLEVBQUV3QixLQUFLLEVBQUVDLE1BQU1FLFFBQVE7SUFDckQsSUFBSVIsUUFBUTtJQUVaLE1BQU1qQixXQUFXRixNQUFNLENBQUNHLE9BQU9ELFFBQVEsQ0FBQyxJQUNsQzBCLGFBQWEsRUFBRTtJQUVyQixJQUFJeEIsWUFBWUYsU0FBU0csSUFBSTtJQUU3QixNQUFPLENBQUNELFVBQVVFLElBQUksQ0FBRTtRQUN0QixJQUFJYSxVQUFVTSxLQUFLO1lBQ2pCO1FBQ0Y7UUFFQSxJQUFJTixTQUFTSyxPQUFPO1lBQ2xCSSxXQUFXQyxJQUFJLENBQUN6QixVQUFVWSxLQUFLLEdBQUcsR0FBRztRQUN2QztRQUVBRztRQUVBZixZQUFZRixTQUFTRyxJQUFJO0lBQzNCO0lBRUEsTUFBTU4sYUFBWTZCLFdBQVdFLElBQUksQ0FBQ0MsdUJBQVk7SUFFOUMsT0FBT2hDO0FBQ1Q7TUFFQSxXQUFlO0lBQ2JGO0lBQ0FDO0lBQ0FGO0lBQ0FHO0FBQ0YifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlsaXRpZXMvc3RyaW5nLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgZnVuY3Rpb24gc3RybGVuKHN0cmluZykge1xuICBsZXQgbGVuZ3RoID0gMDtcblxuICBmb3IgKGNvbnN0IF8gb2Ygc3RyaW5nKSB7XG4gICAgbGVuZ3RoKys7XG4gIH1cblxuICByZXR1cm4gbGVuZ3RoO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gc3RyY21wKHN0cmluZ0EsIHN0cmluZ0IpIHtcbiAgbGV0IGRpZmZlcmVuY2UgPSAwO1xuXG4gIGxldCBuYWl2ZUluZGV4QSA9IDAsXG4gICAgICBuYWl2ZUluZGV4QiA9IDA7XG5cbiAgY29uc3Qgc3RyaW5nQU5haXZlTGVuZ3RoID0gc3RyaW5nQS5sZW5ndGgsXG4gICAgICAgIHN0cmluZ0JOYWl2ZUxlbmd0aCA9IHN0cmluZ0IubGVuZ3RoO1xuXG4gIHdoaWxlICgobmFpdmVJbmRleEEgPCBzdHJpbmdBTmFpdmVMZW5ndGgpIHx8IChuYWl2ZUluZGV4QiA8IHN0cmluZ0JOYWl2ZUxlbmd0aCkpIHtcbiAgICBjb25zdCBjb2RlUG9pbnRBID0gKG5haXZlSW5kZXhBIDwgc3RyaW5nQU5haXZlTGVuZ3RoKSA/XG4gICAgICAgICAgICAgICAgICAgICAgICAgc3RyaW5nQS5jb2RlUG9pbnRBdChuYWl2ZUluZGV4QSkgOlxuICAgICAgICAgICAgICAgICAgICAgICAgICAgMCxcbiAgICAgICAgICBjb2RlUG9pbnRCID0gKG5haXZlSW5kZXhCIDwgc3RyaW5nQk5haXZlTGVuZ3RoKSA/XG4gICAgICAgICAgICAgICAgICAgICAgICAgc3RyaW5nQi5jb2RlUG9pbnRBdChuYWl2ZUluZGV4QikgOlxuICAgICAgICAgICAgICAgICAgICAgICAgICAgMDtcblxuICAgIGRpZmZlcmVuY2UgPSAoY29kZVBvaW50QSAtIGNvZGVQb2ludEIpO1xuXG4gICAgaWYgKGRpZmZlcmVuY2UgIT09IDApIHtcbiAgICAgIGJyZWFrO1xuICAgIH1cblxuICAgIG5haXZlSW5kZXhBICs9IChjb2RlUG9pbnRBID4gMHhGRkZGKSA/XG4gICAgICAgICAgICAgICAgMiA6XG4gICAgICAgICAgICAgICAgICAxO1xuXG4gICAgbmFpdmVJbmRleEIgKz0gKGNvZGVQb2ludEIgPiAweEZGRkYpID9cbiAgICAgICAgICAgICAgICAyIDpcbiAgICAgICAgICAgICAgICAgIDE7XG4gIH1cblxuICByZXR1cm4gZGlmZmVyZW5jZTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGluZGV4T2Yoc3RyaW5nLCBzZWFyY2hTdHJpbmcpIHtcbiAgbGV0IGluZGV4ID0gLTE7XG5cbiAgY29uc3Qgc2VhcmNoU3RyaW5nTGVuZ3RoID0gc2VhcmNoU3RyaW5nLmxlbmd0aDtcblxuICBpZiAoc2VhcmNoU3RyaW5nTGVuZ3RoID4gMCkge1xuICAgIGNvbnN0IG91dGVyTmFpdmVJbmRleCA9IHN0cmluZy5pbmRleE9mKHNlYXJjaFN0cmluZyk7XG5cbiAgICBpZiAob3V0ZXJOYWl2ZUluZGV4ID4gLTEpIHtcbiAgICAgIGluZGV4ID0gMDtcblxuICAgICAgbGV0IGlubmVyTmFpdmVJbmRleCA9IDA7XG5cbiAgICAgIHdoaWxlIChpbm5lck5haXZlSW5kZXggPCBvdXRlck5haXZlSW5kZXgpIHtcbiAgICAgICAgY29uc3QgY2hhckNvZGUgPSBzdHJpbmcuY2hhckNvZGVBdChpbm5lck5haXZlSW5kZXgpO1xuXG4gICAgICAgIGlubmVyTmFpdmVJbmRleCArPSAoKGNoYXJDb2RlID49IDB4RDgwMCkgJiYgKGNoYXJDb2RlIDw9IDB4REJGRikpID9cbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgMiA6XG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgMTtcblxuICAgICAgICBpbmRleCsrO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiBpbmRleDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHN1YnN0cmluZyhzdHJpbmcsIHN0YXJ0LCBlbmQgPSBJbmZpbml0eSkge1xuICBjb25zdCBzdHJpbmdOYWl2ZUxlbmd0aCA9IHN0cmluZy5sZW5ndGg7XG5cbiAgbGV0IGluZGV4ID0gMCxcbiAgICAgIG5haXZlSW5kZXggPSAwLFxuICAgICAgbmFpdmVTdGFydCA9IHN0cmluZ05haXZlTGVuZ3RoLCAvLy9cbiAgICAgIG5haXZlRW5kID0gc3RyaW5nTmFpdmVMZW5ndGg7IC8vL1xuXG4gIHdoaWxlIChuYWl2ZUluZGV4IDwgc3RyaW5nTmFpdmVMZW5ndGgpIHtcbiAgICBpZiAoaW5kZXggPT09IHN0YXJ0KSB7XG4gICAgICBuYWl2ZVN0YXJ0ID0gbmFpdmVJbmRleDsgIC8vL1xuICAgIH1cblxuICAgIGlmIChpbmRleCA9PT0gZW5kKSB7XG4gICAgICBuYWl2ZUVuZCA9IG5haXZlSW5kZXg7ICAvLy9cblxuICAgICAgYnJlYWs7XG4gICAgfVxuXG4gICAgY29uc3QgY2hhckNvZGUgPSBzdHJpbmcuY2hhckNvZGVBdChuYWl2ZUluZGV4KTtcblxuICAgIG5haXZlSW5kZXggKz0gKChjaGFyQ29kZSA+PSAweEQ4MDApICYmIChjaGFyQ29kZSA8PSAweERCRkYpKSA/XG4gICAgICAgICAgICAgICAgICAgIDIgOlxuICAgICAgICAgICAgICAgICAgICAgIDE7XG5cbiAgICBpbmRleCsrO1xuICB9XG5cbiAgaWYgKGluZGV4ID09PSBzdGFydCkge1xuICAgIG5haXZlU3RhcnQgPSBuYWl2ZUluZGV4OyAgLy8vXG4gIH1cblxuICBpZiAoaW5kZXggPT09IGVuZCkge1xuICAgIG5haXZlRW5kID0gbmFpdmVJbmRleDsgIC8vL1xuICB9XG5cbiAgY29uc3Qgc3Vic3RyaW5nID0gc3RyaW5nLnN1YnN0cmluZyhuYWl2ZVN0YXJ0LCBuYWl2ZUVuZCk7XG5cbiAgcmV0dXJuIHN1YnN0cmluZztcbn1cblxuZXhwb3J0IGRlZmF1bHQge1xuICBzdHJjbXAsXG4gIHN0cmxlbixcbiAgaW5kZXhPZixcbiAgc3Vic3RyaW5nXG59O1xuIl0sIm5hbWVzIjpbImluZGV4T2YiLCJzdHJjbXAiLCJzdHJsZW4iLCJzdWJzdHJpbmciLCJzdHJpbmciLCJsZW5ndGgiLCJfIiwic3RyaW5nQSIsInN0cmluZ0IiLCJkaWZmZXJlbmNlIiwibmFpdmVJbmRleEEiLCJuYWl2ZUluZGV4QiIsInN0cmluZ0FOYWl2ZUxlbmd0aCIsInN0cmluZ0JOYWl2ZUxlbmd0aCIsImNvZGVQb2ludEEiLCJjb2RlUG9pbnRBdCIsImNvZGVQb2ludEIiLCJzZWFyY2hTdHJpbmciLCJpbmRleCIsInNlYXJjaFN0cmluZ0xlbmd0aCIsIm91dGVyTmFpdmVJbmRleCIsImlubmVyTmFpdmVJbmRleCIsImNoYXJDb2RlIiwiY2hhckNvZGVBdCIsInN0YXJ0IiwiZW5kIiwiSW5maW5pdHkiLCJzdHJpbmdOYWl2ZUxlbmd0aCIsIm5haXZlSW5kZXgiLCJuYWl2ZVN0YXJ0IiwibmFpdmVFbmQiXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7OztRQW9IQTtlQUFBOztRQXJFZ0JBO2VBQUFBOztRQW5DQUM7ZUFBQUE7O1FBVkFDO2VBQUFBOztRQXlFQUM7ZUFBQUE7OztBQXpFVCxTQUFTRCxPQUFPRSxNQUFNO0lBQzNCLElBQUlDLFNBQVM7SUFFYixLQUFLLE1BQU1DLEtBQUtGLE9BQVE7UUFDdEJDO0lBQ0Y7SUFFQSxPQUFPQTtBQUNUO0FBRU8sU0FBU0osT0FBT00sT0FBTyxFQUFFQyxPQUFPO0lBQ3JDLElBQUlDLGFBQWE7SUFFakIsSUFBSUMsY0FBYyxHQUNkQyxjQUFjO0lBRWxCLE1BQU1DLHFCQUFxQkwsUUFBUUYsTUFBTSxFQUNuQ1EscUJBQXFCTCxRQUFRSCxNQUFNO0lBRXpDLE1BQU8sQUFBQ0ssY0FBY0Usc0JBQXdCRCxjQUFjRSxtQkFBcUI7UUFDL0UsTUFBTUMsYUFBYSxBQUFDSixjQUFjRSxxQkFDYkwsUUFBUVEsV0FBVyxDQUFDTCxlQUNsQixHQUNqQk0sYUFBYSxBQUFDTCxjQUFjRSxxQkFDYkwsUUFBUU8sV0FBVyxDQUFDSixlQUNsQjtRQUV2QkYsYUFBY0ssYUFBYUU7UUFFM0IsSUFBSVAsZUFBZSxHQUFHO1lBQ3BCO1FBQ0Y7UUFFQUMsZUFBZSxBQUFDSSxhQUFhLFNBQ2pCLElBQ0U7UUFFZEgsZUFBZSxBQUFDSyxhQUFhLFNBQ2pCLElBQ0U7SUFDaEI7SUFFQSxPQUFPUDtBQUNUO0FBRU8sU0FBU1QsUUFBUUksTUFBTSxFQUFFYSxZQUFZO0lBQzFDLElBQUlDLFFBQVEsQ0FBQztJQUViLE1BQU1DLHFCQUFxQkYsYUFBYVosTUFBTTtJQUU5QyxJQUFJYyxxQkFBcUIsR0FBRztRQUMxQixNQUFNQyxrQkFBa0JoQixPQUFPSixPQUFPLENBQUNpQjtRQUV2QyxJQUFJRyxrQkFBa0IsQ0FBQyxHQUFHO1lBQ3hCRixRQUFRO1lBRVIsSUFBSUcsa0JBQWtCO1lBRXRCLE1BQU9BLGtCQUFrQkQsZ0JBQWlCO2dCQUN4QyxNQUFNRSxXQUFXbEIsT0FBT21CLFVBQVUsQ0FBQ0Y7Z0JBRW5DQSxtQkFBbUIsQUFBQyxBQUFDQyxZQUFZLFVBQVlBLFlBQVksU0FDcEMsSUFDRTtnQkFFdkJKO1lBQ0Y7UUFDRjtJQUNGO0lBRUEsT0FBT0E7QUFDVDtBQUVPLFNBQVNmLFVBQVVDLE1BQU0sRUFBRW9CLEtBQUssRUFBRUMsTUFBTUMsUUFBUTtJQUNyRCxNQUFNQyxvQkFBb0J2QixPQUFPQyxNQUFNO0lBRXZDLElBQUlhLFFBQVEsR0FDUlUsYUFBYSxHQUNiQyxhQUFhRixtQkFDYkcsV0FBV0gsbUJBQW1CLEdBQUc7SUFFckMsTUFBT0MsYUFBYUQsa0JBQW1CO1FBQ3JDLElBQUlULFVBQVVNLE9BQU87WUFDbkJLLGFBQWFELFlBQWEsR0FBRztRQUMvQjtRQUVBLElBQUlWLFVBQVVPLEtBQUs7WUFDakJLLFdBQVdGLFlBQWEsR0FBRztZQUUzQjtRQUNGO1FBRUEsTUFBTU4sV0FBV2xCLE9BQU9tQixVQUFVLENBQUNLO1FBRW5DQSxjQUFjLEFBQUMsQUFBQ04sWUFBWSxVQUFZQSxZQUFZLFNBQ3BDLElBQ0U7UUFFbEJKO0lBQ0Y7SUFFQSxJQUFJQSxVQUFVTSxPQUFPO1FBQ25CSyxhQUFhRCxZQUFhLEdBQUc7SUFDL0I7SUFFQSxJQUFJVixVQUFVTyxLQUFLO1FBQ2pCSyxXQUFXRixZQUFhLEdBQUc7SUFDN0I7SUFFQSxNQUFNekIsYUFBWUMsT0FBT0QsU0FBUyxDQUFDMEIsWUFBWUM7SUFFL0MsT0FBTzNCO0FBQ1Q7TUFFQSxXQUFlO0lBQ2JGO0lBQ0FDO0lBQ0FGO0lBQ0FHO0FBQ0YifQ==

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "necessary",
   "author": "James Smith",
-  "version": "17.1.7",
+  "version": "17.1.10",
   "license": "MIT, Anti-996",
   "homepage": "https://github.com/djalbat/necessary",
   "description": "A collection of utility functions.",

package/src/utilities/string.js

@@ -1,126 +1,115 @@
 "use strict";
 
-import { EMPTY_STRING } from "../constants";
-
 export function strlen(string) {
   let length = 0;
 
-  const iterator = string[Symbol.iterator]();
-
-  let character = iterator.next();
-
-  while (!character.done) {
-    character = iterator.next();
-
-    length++
+  for (const _ of string) {
+    length++;
   }
 
   return length;
 }
 
 export function strcmp(stringA, stringB) {
-  let difference;
+  let difference = 0;
 
-  const iteratorA = stringA[Symbol.iterator](), ///
-        iteratorB = stringB[Symbol.iterator](); ///
+  let naiveIndexA = 0,
+      naiveIndexB = 0;
 
-  let characterA = iteratorA.next(),
-      characterB = iteratorB.next(),
-      codePointA,
-      codePointB;
+  const stringANaiveLength = stringA.length,
+        stringBNaiveLength = stringB.length;
 
-  while (true) {
-    codePointA = characterA.value ? ///
-                   characterA.value.codePointAt(0) :
-                     0;
-    codePointB = characterB.value ? ///
-                   characterB.value.codePointAt(0) :
-                     0;
+  while ((naiveIndexA < stringANaiveLength) || (naiveIndexB < stringBNaiveLength)) {
+    const codePointA = (naiveIndexA < stringANaiveLength) ?
+                         stringA.codePointAt(naiveIndexA) :
+                           0,
+          codePointB = (naiveIndexB < stringBNaiveLength) ?
+                         stringB.codePointAt(naiveIndexB) :
+                           0;
 
-    difference = codePointB - codePointA;
+    difference = (codePointA - codePointB);
 
     if (difference !== 0) {
       break;
     }
 
-    if (characterA.done || characterB.done) {
-      break;
-    }
+    naiveIndexA += (codePointA > 0xFFFF) ?
+                2 :
+                  1;
 
-    characterA = iteratorA.next();
-    characterB = iteratorB.next();
+    naiveIndexB += (codePointB > 0xFFFF) ?
+                2 :
+                  1;
   }
 
   return difference;
 }
 
 export function indexOf(string, searchString) {
-  let index = -1,
-      found = false;
+  let index = -1;
 
-  const searchStringLength = strlen(searchString);
+  const searchStringLength = searchString.length;
 
   if (searchStringLength > 0) {
-    let character;
-
-    const iterator = string[Symbol.iterator](),
-          searchIterator = searchString[Symbol.iterator](),
-          searchCharacter = searchIterator.next();
+    const outerNaiveIndex = string.indexOf(searchString);
 
-    character = iterator.next();
+    if (outerNaiveIndex > -1) {
+      index = 0;
 
-    index++;
+      let innerNaiveIndex = 0;
 
-    while (!character.done) {
-      if (character.value === searchCharacter.value) {
-        const start = index,  ///
-              end = start + searchStringLength,
-              subString = substring(string, start, end),
-              difference = strcmp(subString, searchString);
+      while (innerNaiveIndex < outerNaiveIndex) {
+        const charCode = string.charCodeAt(innerNaiveIndex);
 
-        if (difference === 0) {
-          found = true;
+        innerNaiveIndex += ((charCode >= 0xD800) && (charCode <= 0xDBFF)) ?
+                             2 :
+                               1;
 
-          break;
-        }
+        index++;
       }
-
-      character = iterator.next();
-
-      index++
     }
   }
 
-  if (!found) {
-    index = -1;
-  }
-
   return index;
 }
 
 export function substring(string, start, end = Infinity) {
-  let index = 0;
+  const stringNaiveLength = string.length;
 
-  const iterator = string[Symbol.iterator](),
-        characters = [];
+  let index = 0,
+      naiveIndex = 0,
+      naiveStart = stringNaiveLength, ///
+      naiveEnd = stringNaiveLength; ///
 
-  let character = iterator.next();
+  while (naiveIndex < stringNaiveLength) {
+    if (index === start) {
+      naiveStart = naiveIndex;  ///
+    }
 
-  while (!character.done) {
     if (index === end) {
+      naiveEnd = naiveIndex;  ///
+
       break;
     }
 
-    if (index >= start) {
-      characters.push(character.value); ///
-    }
+    const charCode = string.charCodeAt(naiveIndex);
 
-    index++
+    naiveIndex += ((charCode >= 0xD800) && (charCode <= 0xDBFF)) ?
+                    2 :
+                      1;
+
+    index++;
+  }
+
+  if (index === start) {
+    naiveStart = naiveIndex;  ///
+  }
 
-    character = iterator.next();
+  if (index === end) {
+    naiveEnd = naiveIndex;  ///
   }
 
-  const substring = characters.join(EMPTY_STRING);
+  const substring = string.substring(naiveStart, naiveEnd);
 
   return substring;
 }