necessary 12.1.4 → 12.2.0

package/README.md

@@ -22,6 +22,7 @@ These can be used both on Node and in the browser:
 * [Path utilities](#path-utilities)
 * [Array utilities](#array-utilities)
 * [HTTP utilities](#http-utilities)
+* [String utilities](#string-utilities)
 * [Version utilities](#version-utilities)
 * [Template utilities](#template-utilities)
 * [Asynchronous utilities](#asynchronous-utilities)
@@ -856,6 +857,55 @@ urlFromHostURIAndQuery(host, uri, query); // returns "https://site.com/user?name
 
 Ideally the `host` argument should not include a trailing forward slash whereas `uri` arguments should always start with a leading forward slash.
 
+## String utilities
+
+- `strcmp()`
+- `strlen()`
+- `substring()`
+
+Substitute functions with support for Unicode. Specifically, characters in Unicode astral plains are counted twice in native functions. These functions fix this issue by converting strings to arrays and if necessary back again. Be warned that for this reason they are nowhere near as fast as their native counterparts.  
+
+* The `strcmp` function takes `stringA` and `stringB` arguments. It compares them character by character in order to find the lexicographically lesser of the two. Its return value is the difference between the code points of the first differing characters, with the code point of either string given as zero if it is empty. Some examples should clarify:
+
+```
+strcmp("", "") = 0;
+
+strcmp("a", "") < 0;
+
+strcmp("", "a") > 0;
+
+strcmp("a", "a") = 0;
+
+strcmp("ab", "a") < 0;
+
+strcmp("ab", "ac") > 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.
+
+Note also that the double-struck `C` is in the basic multilingual plane and has code point `0x02102` whereas the double-struck `𝔸` is in an astral plane and has code point `0x1D538`, therefore their difference is positive.
+
+* The `strlen()` function takes a single `string` argument. It works in much the same way as the `length` property of the `String` prototype, however it is Unicode safe:
+
+```
+"𝔸𝔹C".length = 5  // The 𝔹 and C characters are in an astral plane and count as two each.
+
+strlen("𝔸𝔹C") = 3 // The string is converted to an array whose length is 3.
+
+```
+
+* The `substring()` function takes `string` and `start` arguments and an optional `end` argument. It works in much the same way as the `substring()` method of the `String` prototype, however it is Unicode safe:
+
+```
+"𝔸𝔹C".substring(3) = "C" // The 𝔹 character is in an astral plane and counts as two.  
+
+substring("𝔸𝔹C", 2) = "C" // Again the string is converted to an array and thus the third character is returned.
+```
+
+Note the native `substring()` method can be particularly egregious because the `start` and `end` arguments may result in only half of some characters being returned, so to speak.
+
 ## Version utilities
 
 - `migrate()`

package/lib/browser.js

@@ -51,6 +51,12 @@ _export(exports, {
     statusMessages: function() {
         return _statusMessages.default;
     },
+    stringUtilities: function() {
+        return _string.default;
+    },
+    templateUtilities: function() {
+        return _template.default;
+    },
     versionUtilities: function() {
         return _version.default;
     }
@@ -64,16 +70,18 @@ var _characters = /*#__PURE__*/ _interop_require_default(require("./characters")
 var _statusCodes = /*#__PURE__*/ _interop_require_default(require("./statusCodes"));
 var _contentTypes = /*#__PURE__*/ _interop_require_default(require("./contentTypes"));
 var _statusMessages = /*#__PURE__*/ _interop_require_default(require("./statusMessages"));
-var _ajax = /*#__PURE__*/ _interop_require_default(require("./utilities/ajax"));
 var _path = /*#__PURE__*/ _interop_require_default(require("./utilities/path"));
 var _http = /*#__PURE__*/ _interop_require_default(require("./utilities/http"));
 var _array = /*#__PURE__*/ _interop_require_default(require("./utilities/array"));
+var _string = /*#__PURE__*/ _interop_require_default(require("./utilities/string"));
 var _version = /*#__PURE__*/ _interop_require_default(require("./utilities/version"));
+var _template = /*#__PURE__*/ _interop_require_default(require("./utilities/template"));
 var _asynchronous = /*#__PURE__*/ _interop_require_default(require("./utilities/asynchronous"));
+var _ajax = /*#__PURE__*/ _interop_require_default(require("./utilities/ajax"));
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
     };
 }
 
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgYWpheFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hamF4XCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyB2ZXJzaW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3ZlcnNpb25cIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgYXN5bmNocm9ub3VzVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2FzeW5jaHJvbm91c1wiO1xuIl0sIm5hbWVzIjpbImFqYXhVdGlsaXRpZXMiLCJhcnJheVV0aWxpdGllcyIsImFzeW5jaHJvbm91c1V0aWxpdGllcyIsImNoYXJhY3RlcnMiLCJjb250ZW50VHlwZXMiLCJlbmNvZGluZ3MiLCJoZWFkZXJzIiwiaHR0cFV0aWxpdGllcyIsImtleUNvZGVzIiwibGV2ZWxzIiwibWV0aG9kcyIsInBhdGhVdGlsaXRpZXMiLCJzdGF0dXNDb2RlcyIsInN0YXR1c01lc3NhZ2VzIiwidmVyc2lvblV0aWxpdGllcyJdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7O0lBWW9CQSxhQUFhO2VBQWJBLGFBQWE7O0lBSWJDLGNBQWM7ZUFBZEEsY0FBYzs7SUFFZEMscUJBQXFCO2VBQXJCQSxxQkFBcUI7O0lBWHJCQyxVQUFVO2VBQVZBLG1CQUFVOztJQUVWQyxZQUFZO2VBQVpBLHFCQUFZOztJQUhaQyxTQUFTO2VBQVRBLGtCQUFTOztJQUZUQyxPQUFPO2VBQVBBLGdCQUFPOztJQVdQQyxhQUFhO2VBQWJBLGFBQWE7O0lBVmJDLFFBQVE7ZUFBUkEsaUJBQVE7O0lBSFJDLE1BQU07ZUFBTkEsZUFBTTs7SUFDTkMsT0FBTztlQUFQQSxnQkFBTzs7SUFXUEMsYUFBYTtlQUFiQSxhQUFhOztJQU5iQyxXQUFXO2VBQVhBLG9CQUFXOztJQUVYQyxjQUFjO2VBQWRBLHVCQUFjOztJQU9kQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7OzZEQWZGOzhEQUNDOzhEQUNBOytEQUNDO2dFQUNDO2lFQUNDO2tFQUNDO21FQUNDO3FFQUNFOzJEQUVEOzJEQUVBOzJEQUNBOzREQUNDOzhEQUNFO21FQUNLIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdHJpbmdVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvc3RyaW5nXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIHZlcnNpb25VdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvdmVyc2lvblwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyB0ZW1wbGF0ZVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy90ZW1wbGF0ZVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhc3luY2hyb25vdXNVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvYXN5bmNocm9ub3VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgYWpheFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hamF4XCI7XG4iXSwibmFtZXMiOlsiYWpheFV0aWxpdGllcyIsImFycmF5VXRpbGl0aWVzIiwiYXN5bmNocm9ub3VzVXRpbGl0aWVzIiwiY2hhcmFjdGVycyIsImNvbnRlbnRUeXBlcyIsImVuY29kaW5ncyIsImhlYWRlcnMiLCJodHRwVXRpbGl0aWVzIiwia2V5Q29kZXMiLCJsZXZlbHMiLCJtZXRob2RzIiwicGF0aFV0aWxpdGllcyIsInN0YXR1c0NvZGVzIiwic3RhdHVzTWVzc2FnZXMiLCJzdHJpbmdVdGlsaXRpZXMiLCJ0ZW1wbGF0ZVV0aWxpdGllcyIsInZlcnNpb25VdGlsaXRpZXMiXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7OztJQW9Cb0JBLGFBQWE7ZUFBYkEsYUFBYTs7SUFOYkMsY0FBYztlQUFkQSxjQUFjOztJQUlkQyxxQkFBcUI7ZUFBckJBLHFCQUFxQjs7SUFYckJDLFVBQVU7ZUFBVkEsbUJBQVU7O0lBRVZDLFlBQVk7ZUFBWkEscUJBQVk7O0lBSFpDLFNBQVM7ZUFBVEEsa0JBQVM7O0lBRlRDLE9BQU87ZUFBUEEsZ0JBQU87O0lBU1BDLGFBQWE7ZUFBYkEsYUFBYTs7SUFSYkMsUUFBUTtlQUFSQSxpQkFBUTs7SUFIUkMsTUFBTTtlQUFOQSxlQUFNOztJQUNOQyxPQUFPO2VBQVBBLGdCQUFPOztJQVNQQyxhQUFhO2VBQWJBLGFBQWE7O0lBSmJDLFdBQVc7ZUFBWEEsb0JBQVc7O0lBRVhDLGNBQWM7ZUFBZEEsdUJBQWM7O0lBS2RDLGVBQWU7ZUFBZkEsZUFBZTs7SUFFZkMsaUJBQWlCO2VBQWpCQSxpQkFBaUI7O0lBRGpCQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7OzZEQWRGOzhEQUNDOzhEQUNBOytEQUNDO2dFQUNDO2lFQUNDO2tFQUNDO21FQUNDO3FFQUNFOzJEQUVEOzJEQUNBOzREQUNDOzZEQUNDOzhEQUNDOytEQUNDO21FQUNJOzJEQUVSIn0=

package/lib/main.js

@@ -66,6 +66,9 @@ _export(exports, {
     statusMessages: function() {
         return _statusMessages.default;
     },
+    stringUtilities: function() {
+        return _string.default;
+    },
     templateUtilities: function() {
         return _template.default;
     },
@@ -85,13 +88,14 @@ var _statusMessages = /*#__PURE__*/ _interop_require_default(require("./statusMe
 var _path = /*#__PURE__*/ _interop_require_default(require("./utilities/path"));
 var _http = /*#__PURE__*/ _interop_require_default(require("./utilities/http"));
 var _array = /*#__PURE__*/ _interop_require_default(require("./utilities/array"));
+var _string = /*#__PURE__*/ _interop_require_default(require("./utilities/string"));
 var _version = /*#__PURE__*/ _interop_require_default(require("./utilities/version"));
-var _package = /*#__PURE__*/ _interop_require_default(require("./utilities/package"));
+var _template = /*#__PURE__*/ _interop_require_default(require("./utilities/template"));
 var _asynchronous = /*#__PURE__*/ _interop_require_default(require("./utilities/asynchronous"));
 var _shell = /*#__PURE__*/ _interop_require_default(require("./utilities/shell"));
 var _request = /*#__PURE__*/ _interop_require_default(require("./utilities/request"));
 var _logging = /*#__PURE__*/ _interop_require_default(require("./utilities/logging"));
-var _template = /*#__PURE__*/ _interop_require_default(require("./utilities/template"));
+var _package = /*#__PURE__*/ _interop_require_default(require("./utilities/package"));
 var _fileSystem = /*#__PURE__*/ _interop_require_default(require("./utilities/fileSystem"));
 var _configuration = /*#__PURE__*/ _interop_require_default(require("./utilities/configuration"));
 function _interop_require_default(obj) {
@@ -100,4 +104,4 @@ function _interop_require_default(obj) {
     };
 }
 
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9tYWluLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyB2ZXJzaW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3ZlcnNpb25cIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGFja2FnZVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYWNrYWdlXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGFzeW5jaHJvbm91c1V0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hc3luY2hyb25vdXNcIjtcblxuZXhwb3J0IHsgZGVmYXVsdCBhcyBzaGVsbFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9zaGVsbFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyByZXF1ZXN0VXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3JlcXVlc3RcIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgbG9nZ2luZ1V0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9sb2dnaW5nXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIHRlbXBsYXRlVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3RlbXBsYXRlXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGZpbGVTeXN0ZW1VdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvZmlsZVN5c3RlbVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjb25maWd1cmF0aW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2NvbmZpZ3VyYXRpb25cIjtcbiJdLCJuYW1lcyI6WyJhcnJheVV0aWxpdGllcyIsImFzeW5jaHJvbm91c1V0aWxpdGllcyIsImNoYXJhY3RlcnMiLCJjb25maWd1cmF0aW9uVXRpbGl0aWVzIiwiY29udGVudFR5cGVzIiwiZW5jb2RpbmdzIiwiZmlsZVN5c3RlbVV0aWxpdGllcyIsImhlYWRlcnMiLCJodHRwVXRpbGl0aWVzIiwia2V5Q29kZXMiLCJsZXZlbHMiLCJsb2dnaW5nVXRpbGl0aWVzIiwibWV0aG9kcyIsInBhY2thZ2VVdGlsaXRpZXMiLCJwYXRoVXRpbGl0aWVzIiwicmVxdWVzdFV0aWxpdGllcyIsInNoZWxsVXRpbGl0aWVzIiwic3RhdHVzQ29kZXMiLCJzdGF0dXNNZXNzYWdlcyIsInRlbXBsYXRlVXRpbGl0aWVzIiwidmVyc2lvblV0aWxpdGllcyJdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7O0lBY29CQSxjQUFjO2VBQWRBLGNBQWM7O0lBR2RDLHFCQUFxQjtlQUFyQkEscUJBQXFCOztJQVZyQkMsVUFBVTtlQUFWQSxtQkFBVTs7SUFpQlZDLHNCQUFzQjtlQUF0QkEsc0JBQXNCOztJQWZ0QkMsWUFBWTtlQUFaQSxxQkFBWTs7SUFIWkMsU0FBUztlQUFUQSxrQkFBUzs7SUFpQlRDLG1CQUFtQjtlQUFuQkEsbUJBQW1COztJQW5CbkJDLE9BQU87ZUFBUEEsZ0JBQU87O0lBU1BDLGFBQWE7ZUFBYkEsYUFBYTs7SUFSYkMsUUFBUTtlQUFSQSxpQkFBUTs7SUFIUkMsTUFBTTtlQUFOQSxlQUFNOztJQW1CTkMsZ0JBQWdCO2VBQWhCQSxnQkFBZ0I7O0lBbEJoQkMsT0FBTztlQUFQQSxnQkFBTzs7SUFhUEMsZ0JBQWdCO2VBQWhCQSxnQkFBZ0I7O0lBSmhCQyxhQUFhO2VBQWJBLGFBQWE7O0lBUWJDLGdCQUFnQjtlQUFoQkEsZ0JBQWdCOztJQURoQkMsY0FBYztlQUFkQSxjQUFjOztJQVhkQyxXQUFXO2VBQVhBLG9CQUFXOztJQUVYQyxjQUFjO2VBQWRBLHVCQUFjOztJQVlkQyxpQkFBaUI7ZUFBakJBLGlCQUFpQjs7SUFQakJDLGdCQUFnQjtlQUFoQkEsZ0JBQWdCOzs7NkRBYkY7OERBQ0M7OERBQ0E7K0RBQ0M7Z0VBQ0M7aUVBQ0M7a0VBQ0M7bUVBQ0M7cUVBQ0U7MkRBRUQ7MkRBQ0E7NERBQ0M7OERBQ0U7OERBQ0E7bUVBQ0s7NERBRVA7OERBQ0U7OERBQ0E7K0RBQ0M7aUVBQ0U7b0VBQ0cifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9tYWluLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdHJpbmdVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvc3RyaW5nXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIHZlcnNpb25VdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvdmVyc2lvblwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyB0ZW1wbGF0ZVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy90ZW1wbGF0ZVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhc3luY2hyb25vdXNVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvYXN5bmNocm9ub3VzXCI7XG5cblxuXG5leHBvcnQgeyBkZWZhdWx0IGFzIHNoZWxsVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3NoZWxsXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIHJlcXVlc3RVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvcmVxdWVzdFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBsb2dnaW5nVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2xvZ2dpbmdcIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGFja2FnZVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYWNrYWdlXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGZpbGVTeXN0ZW1VdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvZmlsZVN5c3RlbVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjb25maWd1cmF0aW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2NvbmZpZ3VyYXRpb25cIjtcbiJdLCJuYW1lcyI6WyJhcnJheVV0aWxpdGllcyIsImFzeW5jaHJvbm91c1V0aWxpdGllcyIsImNoYXJhY3RlcnMiLCJjb25maWd1cmF0aW9uVXRpbGl0aWVzIiwiY29udGVudFR5cGVzIiwiZW5jb2RpbmdzIiwiZmlsZVN5c3RlbVV0aWxpdGllcyIsImhlYWRlcnMiLCJodHRwVXRpbGl0aWVzIiwia2V5Q29kZXMiLCJsZXZlbHMiLCJsb2dnaW5nVXRpbGl0aWVzIiwibWV0aG9kcyIsInBhY2thZ2VVdGlsaXRpZXMiLCJwYXRoVXRpbGl0aWVzIiwicmVxdWVzdFV0aWxpdGllcyIsInNoZWxsVXRpbGl0aWVzIiwic3RhdHVzQ29kZXMiLCJzdGF0dXNNZXNzYWdlcyIsInN0cmluZ1V0aWxpdGllcyIsInRlbXBsYXRlVXRpbGl0aWVzIiwidmVyc2lvblV0aWxpdGllcyJdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7O0lBY29CQSxjQUFjO2VBQWRBLGNBQWM7O0lBSWRDLHFCQUFxQjtlQUFyQkEscUJBQXFCOztJQVhyQkMsVUFBVTtlQUFWQSxtQkFBVTs7SUFvQlZDLHNCQUFzQjtlQUF0QkEsc0JBQXNCOztJQWxCdEJDLFlBQVk7ZUFBWkEscUJBQVk7O0lBSFpDLFNBQVM7ZUFBVEEsa0JBQVM7O0lBb0JUQyxtQkFBbUI7ZUFBbkJBLG1CQUFtQjs7SUF0Qm5CQyxPQUFPO2VBQVBBLGdCQUFPOztJQVNQQyxhQUFhO2VBQWJBLGFBQWE7O0lBUmJDLFFBQVE7ZUFBUkEsaUJBQVE7O0lBSFJDLE1BQU07ZUFBTkEsZUFBTTs7SUFzQk5DLGdCQUFnQjtlQUFoQkEsZ0JBQWdCOztJQXJCaEJDLE9BQU87ZUFBUEEsZ0JBQU87O0lBc0JQQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7SUFiaEJDLGFBQWE7ZUFBYkEsYUFBYTs7SUFXYkMsZ0JBQWdCO2VBQWhCQSxnQkFBZ0I7O0lBRGhCQyxjQUFjO2VBQWRBLGNBQWM7O0lBZGRDLFdBQVc7ZUFBWEEsb0JBQVc7O0lBRVhDLGNBQWM7ZUFBZEEsdUJBQWM7O0lBS2RDLGVBQWU7ZUFBZkEsZUFBZTs7SUFFZkMsaUJBQWlCO2VBQWpCQSxpQkFBaUI7O0lBRGpCQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7OzZEQWRGOzhEQUNDOzhEQUNBOytEQUNDO2dFQUNDO2lFQUNDO2tFQUNDO21FQUNDO3FFQUNFOzJEQUVEOzJEQUNBOzREQUNDOzZEQUNDOzhEQUNDOytEQUNDO21FQUNJOzREQUlQOzhEQUNFOzhEQUNBOzhEQUNBO2lFQUNHO29FQUNHIn0=

package/lib/utilities/string.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    default: function() {
+        return _default;
+    },
+    strcmp: function() {
+        return strcmp;
+    },
+    strlen: function() {
+        return strlen;
+    },
+    substring: function() {
+        return substring;
+    }
+});
+var _constants = require("../constants");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function strcmp(stringA, stringB) {
+    var difference;
+    var codePointA = stringA === _constants.EMPTY_STRING ? 0 : stringA.codePointAt(0), codePointB = stringB === _constants.EMPTY_STRING ? 0 : stringB.codePointAt(0);
+    difference = codePointB - codePointA;
+    if (difference === 0 && codePointA !== 0 && codePointB !== 0) {
+        stringA = substring(stringA, 1); ///
+        stringB = substring(stringB, 1); ///
+        difference = strcmp(stringA, stringB);
+    }
+    return difference;
+}
+function strlen(string) {
+    return _to_consumable_array(string).length;
+} ///
+function substring(string, start, end) {
+    return _to_consumable_array(string).slice(start, end).join("");
+} ///
+var _default = {
+    strcmp: strcmp,
+    strlen: strlen,
+    substring: substring
+};
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlsaXRpZXMvc3RyaW5nLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5pbXBvcnQgeyBFTVBUWV9TVFJJTkcgfSBmcm9tIFwiLi4vY29uc3RhbnRzXCI7XG5cbmV4cG9ydCBmdW5jdGlvbiBzdHJjbXAoc3RyaW5nQSwgc3RyaW5nQikge1xuICBsZXQgZGlmZmVyZW5jZTtcblxuICBjb25zdCBjb2RlUG9pbnRBID0gKHN0cmluZ0EgPT09IEVNUFRZX1NUUklORykgP1xuICAgICAgICAgICAgICAgICAgICAgICAwIDpcbiAgICAgICAgICAgICAgICAgICAgICAgICBzdHJpbmdBLmNvZGVQb2ludEF0KDApLFxuICAgICAgICBjb2RlUG9pbnRCID0gKHN0cmluZ0IgPT09IEVNUFRZX1NUUklORykgP1xuICAgICAgICAgICAgICAgICAgICAgICAwIDpcbiAgICAgICAgICAgICAgICAgICAgICAgICBzdHJpbmdCLmNvZGVQb2ludEF0KDApO1xuXG4gIGRpZmZlcmVuY2UgPSBjb2RlUG9pbnRCIC0gY29kZVBvaW50QTtcblxuICBpZiAoKGRpZmZlcmVuY2UgPT09IDApICYmIChjb2RlUG9pbnRBICE9PTApICYmIChjb2RlUG9pbnRCICE9PTApKSB7XG4gICAgc3RyaW5nQSA9IHN1YnN0cmluZyhzdHJpbmdBLCAxKTsgLy8vXG5cbiAgICBzdHJpbmdCID0gc3Vic3RyaW5nKHN0cmluZ0IsIDEpOyAvLy9cblxuICAgIGRpZmZlcmVuY2UgPSBzdHJjbXAoc3RyaW5nQSwgc3RyaW5nQik7XG4gIH1cblxuICByZXR1cm4gZGlmZmVyZW5jZTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHN0cmxlbihzdHJpbmcpIHsgcmV0dXJuIFsuLi5zdHJpbmddLmxlbmd0aDsgfSAvLy9cblxuZXhwb3J0IGZ1bmN0aW9uIHN1YnN0cmluZyhzdHJpbmcsIHN0YXJ0LCBlbmQpIHsgcmV0dXJuIFsuLi5zdHJpbmddLnNsaWNlKHN0YXJ0LCBlbmQpLmpvaW4oXCJcIik7IH0gIC8vL1xuXG5leHBvcnQgZGVmYXVsdCB7XG4gIHN0cmNtcCxcbiAgc3RybGVuLFxuICBzdWJzdHJpbmdcbn07XG4iXSwibmFtZXMiOlsic3RyY21wIiwic3RybGVuIiwic3Vic3RyaW5nIiwic3RyaW5nQSIsInN0cmluZ0IiLCJkaWZmZXJlbmNlIiwiY29kZVBvaW50QSIsIkVNUFRZX1NUUklORyIsImNvZGVQb2ludEF0IiwiY29kZVBvaW50QiIsInN0cmluZyIsImxlbmd0aCIsInN0YXJ0IiwiZW5kIiwic2xpY2UiLCJqb2luIl0sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7SUErQkEsT0FJRTtlQUpGOztJQTNCZ0JBLE1BQU07ZUFBTkE7O0lBdUJBQyxNQUFNO2VBQU5BOztJQUVBQyxTQUFTO2VBQVRBOzs7eUJBM0JhOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUV0QixTQUFTRixPQUFPRyxPQUFPLEVBQUVDLE9BQU87SUFDckMsSUFBSUM7SUFFSixJQUFNQyxhQUFhLEFBQUNILFlBQVlJLHVCQUFZLEdBQ3ZCLElBQ0VKLFFBQVFLLFdBQVcsQ0FBQyxJQUNyQ0MsYUFBYSxBQUFDTCxZQUFZRyx1QkFBWSxHQUN2QixJQUNFSCxRQUFRSSxXQUFXLENBQUM7SUFFM0NILGFBQWFJLGFBQWFIO0lBRTFCLElBQUksQUFBQ0QsZUFBZSxLQUFPQyxlQUFjLEtBQU9HLGVBQWMsR0FBSTtRQUNoRU4sVUFBVUQsVUFBVUMsU0FBUyxJQUFJLEdBQUc7UUFFcENDLFVBQVVGLFVBQVVFLFNBQVMsSUFBSSxHQUFHO1FBRXBDQyxhQUFhTCxPQUFPRyxTQUFTQztJQUMvQjtJQUVBLE9BQU9DO0FBQ1Q7QUFFTyxTQUFTSixPQUFPUyxNQUFNO0lBQUksT0FBTyxBQUFDLHFCQUFHQSxRQUFRQyxNQUFNO0FBQUUsRUFBRSxHQUFHO0FBRTFELFNBQVNULFVBQVVRLE1BQU0sRUFBRUUsS0FBSyxFQUFFQyxHQUFHO0lBQUksT0FBTyxBQUFDLHFCQUFHSCxRQUFRSSxLQUFLLENBQUNGLE9BQU9DLEtBQUtFLElBQUksQ0FBQztBQUFLLEVBQUcsR0FBRztJQUVyRyxXQUFlO0lBQ2JmLFFBQUFBO0lBQ0FDLFFBQUFBO0lBQ0FDLFdBQUFBO0FBQ0YifQ==

package/package.json

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

package/src/browser.js

@@ -10,10 +10,12 @@ export { default as statusCodes } from "./statusCodes";
 export { default as contentTypes } from "./contentTypes";
 export { default as statusMessages } from "./statusMessages";
 
-export { default as ajaxUtilities } from "./utilities/ajax";
-
 export { default as pathUtilities } from "./utilities/path";
 export { default as httpUtilities } from "./utilities/http";
 export { default as arrayUtilities } from "./utilities/array";
+export { default as stringUtilities } from "./utilities/string";
 export { default as versionUtilities } from "./utilities/version";
+export { default as templateUtilities } from "./utilities/template";
 export { default as asynchronousUtilities } from "./utilities/asynchronous";
+
+export { default as ajaxUtilities } from "./utilities/ajax";

package/src/main.js

@@ -13,13 +13,16 @@ export { default as statusMessages } from "./statusMessages";
 export { default as pathUtilities } from "./utilities/path";
 export { default as httpUtilities } from "./utilities/http";
 export { default as arrayUtilities } from "./utilities/array";
+export { default as stringUtilities } from "./utilities/string";
 export { default as versionUtilities } from "./utilities/version";
-export { default as packageUtilities } from "./utilities/package";
+export { default as templateUtilities } from "./utilities/template";
 export { default as asynchronousUtilities } from "./utilities/asynchronous";
 
+
+
 export { default as shellUtilities } from "./utilities/shell";
 export { default as requestUtilities } from "./utilities/request";
 export { default as loggingUtilities } from "./utilities/logging";
-export { default as templateUtilities } from "./utilities/template";
+export { default as packageUtilities } from "./utilities/package";
 export { default as fileSystemUtilities } from "./utilities/fileSystem";
 export { default as configurationUtilities } from "./utilities/configuration";

package/src/utilities/string.js

@@ -0,0 +1,36 @@
+"use strict";
+
+import { EMPTY_STRING } from "../constants";
+
+export function strcmp(stringA, stringB) {
+  let difference;
+
+  const codePointA = (stringA === EMPTY_STRING) ?
+                       0 :
+                         stringA.codePointAt(0),
+        codePointB = (stringB === EMPTY_STRING) ?
+                       0 :
+                         stringB.codePointAt(0);
+
+  difference = codePointB - codePointA;
+
+  if ((difference === 0) && (codePointA !==0) && (codePointB !==0)) {
+    stringA = substring(stringA, 1); ///
+
+    stringB = substring(stringB, 1); ///
+
+    difference = strcmp(stringA, stringB);
+  }
+
+  return difference;
+}
+
+export function strlen(string) { return [...string].length; } ///
+
+export function substring(string, start, end) { return [...string].slice(start, end).join(""); }  ///
+
+export default {
+  strcmp,
+  strlen,
+  substring
+};