locutus 2.0.31 → 2.0.34

package/php/strings/sha1_file.js

@@ -1,23 +1,21 @@
-'use strict';
-
 module.exports = function sha1_file(str_filename) {
-  //  discuss at: https://locutus.io/php/sha1_file/
-  // original by: Kevin van Zonneveld (https://kvz.io)
-  //      note 1: Relies on file_get_contents which does not work in the browser, so Node only.
-  //      note 2: Keep in mind that in accordance with PHP, the whole file is buffered and then
-  //      note 2: hashed. We'd recommend Node's native crypto modules for faster and more
-  //      note 2: efficient hashing
-  //   example 1: sha1_file('test/never-change.txt')
-  //   returns 1: '0ea65a1f4b4d69712affc58240932f3eb8a2af66'
+  //      discuss at: https://locutus.io/php/sha1_file/
+  // parity verified: PHP 8.3
+  //     original by: Kevin van Zonneveld (https://kvz.io)
+  //          note 1: Relies on file_get_contents which does not work in the browser, so Node only.
+  //          note 2: Keep in mind that in accordance with PHP, the whole file is buffered and then
+  //          note 2: hashed. We'd recommend Node's native crypto modules for faster and more
+  //          note 2: efficient hashing
+  //       example 1: sha1_file('test/never-change.txt')
+  //       returns 1: '0ea65a1f4b4d69712affc58240932f3eb8a2af66'
 
-  var fileGetContents = require('../filesystem/file_get_contents');
-  var sha1 = require('../strings/sha1');
-  var buf = fileGetContents(str_filename);
+  const fileGetContents = require('../filesystem/file_get_contents')
+  const sha1 = require('../strings/sha1')
+  const buf = fileGetContents(str_filename)
 
   if (buf === false) {
-    return false;
+    return false
   }
 
-  return sha1(buf);
-};
-//# sourceMappingURL=sha1_file.js.map
+  return sha1(buf)
+}

package/php/strings/similar_text.js

@@ -1,32 +1,31 @@
-'use strict';
-
 module.exports = function similar_text(first, second, percent) {
-  //  discuss at: https://locutus.io/php/similar_text/
-  // original by: Rafał Kukawski (https://blog.kukawski.pl)
-  // bugfixed by: Chris McMacken
-  // bugfixed by: Jarkko Rantavuori original by findings in stackoverflow (https://stackoverflow.com/questions/14136349/how-does-similar-text-work)
-  // improved by: Markus Padourek (taken from https://www.kevinhq.com/2012/06/php-similartext-function-in-javascript_16.html)
-  //   example 1: similar_text('Hello World!', 'Hello locutus!')
-  //   returns 1: 8
-  //   example 2: similar_text('Hello World!', null)
-  //   returns 2: 0
+  //      discuss at: https://locutus.io/php/similar_text/
+  // parity verified: PHP 8.3
+  //     original by: Rafał Kukawski (https://blog.kukawski.pl)
+  //     bugfixed by: Chris McMacken
+  //     bugfixed by: Jarkko Rantavuori original by findings in stackoverflow (https://stackoverflow.com/questions/14136349/how-does-similar-text-work)
+  //     improved by: Markus Padourek (taken from https://www.kevinhq.com/2012/06/php-similartext-function-in-javascript_16.html)
+  //       example 1: similar_text('Hello World!', 'Hello locutus!')
+  //       returns 1: 8
+  //       example 2: similar_text('Hello World!', null)
+  //       returns 2: 0
 
   if (first === null || second === null || typeof first === 'undefined' || typeof second === 'undefined') {
-    return 0;
+    return 0
   }
 
-  first += '';
-  second += '';
+  first += ''
+  second += ''
 
-  var pos1 = 0;
-  var pos2 = 0;
-  var max = 0;
-  var firstLength = first.length;
-  var secondLength = second.length;
-  var p = void 0;
-  var q = void 0;
-  var l = void 0;
-  var sum = void 0;
+  let pos1 = 0
+  let pos2 = 0
+  let max = 0
+  const firstLength = first.length
+  const secondLength = second.length
+  let p
+  let q
+  let l
+  let sum
 
   for (p = 0; p < firstLength; p++) {
     for (q = 0; q < secondLength; q++) {
@@ -34,29 +33,31 @@ module.exports = function similar_text(first, second, percent) {
         // @todo: ^-- break up this crazy for loop and put the logic in its body
       }
       if (l > max) {
-        max = l;
-        pos1 = p;
-        pos2 = q;
+        max = l
+        pos1 = p
+        pos2 = q
       }
     }
   }
 
-  sum = max;
+  sum = max
 
   if (sum) {
     if (pos1 && pos2) {
-      sum += similar_text(first.substr(0, pos1), second.substr(0, pos2));
+      sum += similar_text(first.substr(0, pos1), second.substr(0, pos2))
     }
 
     if (pos1 + max < firstLength && pos2 + max < secondLength) {
-      sum += similar_text(first.substr(pos1 + max, firstLength - pos1 - max), second.substr(pos2 + max, secondLength - pos2 - max));
+      sum += similar_text(
+        first.substr(pos1 + max, firstLength - pos1 - max),
+        second.substr(pos2 + max, secondLength - pos2 - max),
+      )
     }
   }
 
   if (!percent) {
-    return sum;
+    return sum
   }
 
-  return sum * 200 / (firstLength + secondLength);
-};
-//# sourceMappingURL=similar_text.js.map
+  return (sum * 200) / (firstLength + secondLength)
+}

package/php/strings/soundex.js

@@ -1,29 +1,28 @@
-'use strict';
-
 module.exports = function soundex(str) {
-  //  discuss at: https://locutus.io/php/soundex/
-  // original by: Jonas Raoni Soares Silva (https://www.jsfromhell.com)
-  // original by: Arnout Kazemier (https://www.3rd-Eden.com)
-  // improved by: Jack
-  // improved by: Kevin van Zonneveld (https://kvz.io)
-  // bugfixed by: Onno Marsman (https://twitter.com/onnomarsman)
-  // bugfixed by: Kevin van Zonneveld (https://kvz.io)
-  //    input by: Brett Zamir (https://brett-zamir.me)
-  //  revised by: Rafał Kukawski (https://blog.kukawski.pl)
-  //   example 1: soundex('Kevin')
-  //   returns 1: 'K150'
-  //   example 2: soundex('Ellery')
-  //   returns 2: 'E460'
-  //   example 3: soundex('Euler')
-  //   returns 3: 'E460'
+  //      discuss at: https://locutus.io/php/soundex/
+  // parity verified: PHP 8.3
+  //     original by: Jonas Raoni Soares Silva (https://www.jsfromhell.com)
+  //     original by: Arnout Kazemier (https://www.3rd-Eden.com)
+  //     improved by: Jack
+  //     improved by: Kevin van Zonneveld (https://kvz.io)
+  //     bugfixed by: Onno Marsman (https://twitter.com/onnomarsman)
+  //     bugfixed by: Kevin van Zonneveld (https://kvz.io)
+  //        input by: Brett Zamir (https://brett-zamir.me)
+  //      revised by: Rafał Kukawski (https://blog.kukawski.pl)
+  //       example 1: soundex('Kevin')
+  //       returns 1: 'K150'
+  //       example 2: soundex('Ellery')
+  //       returns 2: 'E460'
+  //       example 3: soundex('Euler')
+  //       returns 3: 'E460'
 
-  str = (str + '').toUpperCase();
+  str = (str + '').toUpperCase()
   if (!str) {
-    return '';
+    return ''
   }
 
-  var sdx = [0, 0, 0, 0];
-  var m = {
+  const sdx = [0, 0, 0, 0]
+  const m = {
     B: 1,
     F: 1,
     P: 1,
@@ -41,27 +40,26 @@ module.exports = function soundex(str) {
     L: 4,
     M: 5,
     N: 5,
-    R: 6
-  };
-  var i = 0;
-  var j = void 0;
-  var s = 0;
-  var c = void 0;
-  var p = void 0;
+    R: 6,
+  }
+  let i = 0
+  let j
+  let s = 0
+  let c
+  let p
 
   while ((c = str.charAt(i++)) && s < 4) {
-    if (j = m[c]) {
+    if ((j = m[c])) {
       if (j !== p) {
-        sdx[s++] = p = j;
+        sdx[s++] = p = j
       }
     } else {
-      s += i === 1;
-      p = 0;
+      s += i === 1
+      p = 0
     }
   }
 
-  sdx[0] = str.charAt(0);
+  sdx[0] = str.charAt(0)
 
-  return sdx.join('');
-};
-//# sourceMappingURL=soundex.js.map
+  return sdx.join('')
+}

package/php/strings/split.js

@@ -1,12 +1,10 @@
-'use strict';
-
 module.exports = function split(delimiter, string) {
-  //  discuss at: https://locutus.io/php/split/
-  // original by: Kevin van Zonneveld (https://kvz.io)
-  //   example 1: split(' ', 'Kevin van Zonneveld')
-  //   returns 1: ['Kevin', 'van', 'Zonneveld']
+  //      discuss at: https://locutus.io/php/split/
+  // parity verified: PHP 8.3
+  //     original by: Kevin van Zonneveld (https://kvz.io)
+  //       example 1: split(' ', 'Kevin van Zonneveld')
+  //       returns 1: ['Kevin', 'van', 'Zonneveld']
 
-  var explode = require('../strings/explode');
-  return explode(delimiter, string);
-};
-//# sourceMappingURL=split.js.map
+  const explode = require('../strings/explode')
+  return explode(delimiter, string)
+}

package/php/strings/sprintf.js

@@ -1,198 +1,196 @@
-'use strict';
-
 module.exports = function sprintf() {
-  //  discuss at: https://locutus.io/php/sprintf/
-  // original by: Ash Searle (https://hexmen.com/blog/)
-  // improved by: Michael White (https://getsprink.com)
-  // improved by: Jack
-  // improved by: Kevin van Zonneveld (https://kvz.io)
-  // improved by: Kevin van Zonneveld (https://kvz.io)
-  // improved by: Kevin van Zonneveld (https://kvz.io)
-  // improved by: Dj
-  // improved by: Allidylls
-  //    input by: Paulo Freitas
-  //    input by: Brett Zamir (https://brett-zamir.me)
-  // improved by: Rafał Kukawski (https://kukawski.pl)
-  //   example 1: sprintf("%01.2f", 123.1)
-  //   returns 1: '123.10'
-  //   example 2: sprintf("[%10s]", 'monkey')
-  //   returns 2: '[    monkey]'
-  //   example 3: sprintf("[%'#10s]", 'monkey')
-  //   returns 3: '[####monkey]'
-  //   example 4: sprintf("%d", 123456789012345)
-  //   returns 4: '123456789012345'
-  //   example 5: sprintf('%-03s', 'E')
-  //   returns 5: 'E00'
-  //   example 6: sprintf('%+010d', 9)
-  //   returns 6: '+000000009'
-  //   example 7: sprintf('%+0\'@10d', 9)
-  //   returns 7: '@@@@@@@@+9'
-  //   example 8: sprintf('%.f', 3.14)
-  //   returns 8: '3.140000'
-  //   example 9: sprintf('%% %2$d', 1, 2)
-  //   returns 9: '% 2'
-
-  var regex = /%%|%(?:(\d+)\$)?((?:[-+#0 ]|'[\s\S])*)(\d+)?(?:\.(\d*))?([\s\S])/g;
-  var args = arguments;
-  var i = 0;
-  var format = args[i++];
-
-  var _pad = function _pad(str, len, chr, leftJustify) {
+  //      discuss at: https://locutus.io/php/sprintf/
+  // parity verified: PHP 8.3
+  //     original by: Ash Searle (https://hexmen.com/blog/)
+  //     improved by: Michael White (https://getsprink.com)
+  //     improved by: Jack
+  //     improved by: Kevin van Zonneveld (https://kvz.io)
+  //     improved by: Kevin van Zonneveld (https://kvz.io)
+  //     improved by: Kevin van Zonneveld (https://kvz.io)
+  //     improved by: Dj
+  //     improved by: Allidylls
+  //        input by: Paulo Freitas
+  //        input by: Brett Zamir (https://brett-zamir.me)
+  //     improved by: Rafał Kukawski (https://kukawski.pl)
+  //       example 1: sprintf("%01.2f", 123.1)
+  //       returns 1: '123.10'
+  //       example 2: sprintf("[%10s]", 'monkey')
+  //       returns 2: '[    monkey]'
+  //       example 3: sprintf("[%'#10s]", 'monkey')
+  //       returns 3: '[####monkey]'
+  //       example 4: sprintf("%d", 123456789012345)
+  //       returns 4: '123456789012345'
+  //       example 5: sprintf('%-03s', 'E')
+  //       returns 5: 'E00'
+  //       example 6: sprintf('%+010d', 9)
+  //       returns 6: '+000000009'
+  //       example 7: sprintf('%+0\'@10d', 9)
+  //       returns 7: '@@@@@@@@+9'
+  //       example 8: sprintf('%.f', 3.14)
+  //       returns 8: '3.140000'
+  //       example 9: sprintf('%% %2$d', 1, 2)
+  //       returns 9: '% 2'
+
+  const regex = /%%|%(?:(\d+)\$)?((?:[-+#0 ]|'[\s\S])*)(\d+)?(?:\.(\d*))?([\s\S])/g
+  const args = arguments
+  let i = 0
+  const format = args[i++]
+
+  const _pad = function (str, len, chr, leftJustify) {
     if (!chr) {
-      chr = ' ';
+      chr = ' '
     }
-    var padding = str.length >= len ? '' : new Array(1 + len - str.length >>> 0).join(chr);
-    return leftJustify ? str + padding : padding + str;
-  };
+    const padding = str.length >= len ? '' : new Array((1 + len - str.length) >>> 0).join(chr)
+    return leftJustify ? str + padding : padding + str
+  }
 
-  var justify = function justify(value, prefix, leftJustify, minWidth, padChar) {
-    var diff = minWidth - value.length;
+  const justify = function (value, prefix, leftJustify, minWidth, padChar) {
+    const diff = minWidth - value.length
     if (diff > 0) {
       // when padding with zeros
       // on the left side
       // keep sign (+ or -) in front
       if (!leftJustify && padChar === '0') {
-        value = [value.slice(0, prefix.length), _pad('', diff, '0', true), value.slice(prefix.length)].join('');
+        value = [value.slice(0, prefix.length), _pad('', diff, '0', true), value.slice(prefix.length)].join('')
       } else {
-        value = _pad(value, minWidth, padChar, leftJustify);
+        value = _pad(value, minWidth, padChar, leftJustify)
       }
     }
-    return value;
-  };
+    return value
+  }
 
-  var _formatBaseX = function _formatBaseX(value, base, leftJustify, minWidth, precision, padChar) {
+  const _formatBaseX = function (value, base, leftJustify, minWidth, precision, padChar) {
     // Note: casts negative numbers to positive ones
-    var number = value >>> 0;
-    value = _pad(number.toString(base), precision || 0, '0', false);
-    return justify(value, '', leftJustify, minWidth, padChar);
-  };
+    const number = value >>> 0
+    value = _pad(number.toString(base), precision || 0, '0', false)
+    return justify(value, '', leftJustify, minWidth, padChar)
+  }
 
   // _formatString()
-  var _formatString = function _formatString(value, leftJustify, minWidth, precision, customPadChar) {
+  const _formatString = function (value, leftJustify, minWidth, precision, customPadChar) {
     if (precision !== null && precision !== undefined) {
-      value = value.slice(0, precision);
+      value = value.slice(0, precision)
     }
-    return justify(value, '', leftJustify, minWidth, customPadChar);
-  };
+    return justify(value, '', leftJustify, minWidth, customPadChar)
+  }
 
   // doFormat()
-  var doFormat = function doFormat(substring, argIndex, modifiers, minWidth, precision, specifier) {
-    var number = void 0,
-        prefix = void 0,
-        method = void 0,
-        textTransform = void 0,
-        value = void 0;
+  const doFormat = function (substring, argIndex, modifiers, minWidth, precision, specifier) {
+    let number
+    let prefix
+    let method
+    let textTransform
+    let value
 
     if (substring === '%%') {
-      return '%';
+      return '%'
     }
 
     // parse modifiers
-    var padChar = ' '; // pad with spaces by default
-    var leftJustify = false;
-    var positiveNumberPrefix = '';
-    var j = void 0,
-        l = void 0;
+    let padChar = ' ' // pad with spaces by default
+    let leftJustify = false
+    let positiveNumberPrefix = ''
+    let j
+    let l
 
     for (j = 0, l = modifiers.length; j < l; j++) {
       switch (modifiers.charAt(j)) {
         case ' ':
         case '0':
-          padChar = modifiers.charAt(j);
-          break;
+          padChar = modifiers.charAt(j)
+          break
         case '+':
-          positiveNumberPrefix = '+';
-          break;
+          positiveNumberPrefix = '+'
+          break
         case '-':
-          leftJustify = true;
-          break;
+          leftJustify = true
+          break
         case "'":
           if (j + 1 < l) {
-            padChar = modifiers.charAt(j + 1);
-            j++;
+            padChar = modifiers.charAt(j + 1)
+            j++
           }
-          break;
+          break
       }
     }
 
     if (!minWidth) {
-      minWidth = 0;
+      minWidth = 0
     } else {
-      minWidth = +minWidth;
+      minWidth = +minWidth
     }
 
     if (!isFinite(minWidth)) {
-      throw new Error('Width must be finite');
+      throw new Error('Width must be finite')
     }
 
     if (!precision) {
-      precision = specifier === 'd' ? 0 : 'fFeE'.indexOf(specifier) > -1 ? 6 : undefined;
+      precision = specifier === 'd' ? 0 : 'fFeE'.indexOf(specifier) > -1 ? 6 : undefined
     } else {
-      precision = +precision;
+      precision = +precision
     }
 
     if (argIndex && +argIndex === 0) {
-      throw new Error('Argument number must be greater than zero');
+      throw new Error('Argument number must be greater than zero')
     }
 
     if (argIndex && +argIndex >= args.length) {
-      throw new Error('Too few arguments');
+      throw new Error('Too few arguments')
     }
 
-    value = argIndex ? args[+argIndex] : args[i++];
+    value = argIndex ? args[+argIndex] : args[i++]
 
     switch (specifier) {
       case '%':
-        return '%';
+        return '%'
       case 's':
-        return _formatString(value + '', leftJustify, minWidth, precision, padChar);
+        return _formatString(value + '', leftJustify, minWidth, precision, padChar)
       case 'c':
-        return _formatString(String.fromCharCode(+value), leftJustify, minWidth, precision, padChar);
+        return _formatString(String.fromCharCode(+value), leftJustify, minWidth, precision, padChar)
       case 'b':
-        return _formatBaseX(value, 2, leftJustify, minWidth, precision, padChar);
+        return _formatBaseX(value, 2, leftJustify, minWidth, precision, padChar)
       case 'o':
-        return _formatBaseX(value, 8, leftJustify, minWidth, precision, padChar);
+        return _formatBaseX(value, 8, leftJustify, minWidth, precision, padChar)
       case 'x':
-        return _formatBaseX(value, 16, leftJustify, minWidth, precision, padChar);
+        return _formatBaseX(value, 16, leftJustify, minWidth, precision, padChar)
       case 'X':
-        return _formatBaseX(value, 16, leftJustify, minWidth, precision, padChar).toUpperCase();
+        return _formatBaseX(value, 16, leftJustify, minWidth, precision, padChar).toUpperCase()
       case 'u':
-        return _formatBaseX(value, 10, leftJustify, minWidth, precision, padChar);
+        return _formatBaseX(value, 10, leftJustify, minWidth, precision, padChar)
       case 'i':
       case 'd':
-        number = +value || 0;
+        number = +value || 0
         // Plain Math.round doesn't just truncate
-        number = Math.round(number - number % 1);
-        prefix = number < 0 ? '-' : positiveNumberPrefix;
-        value = prefix + _pad(String(Math.abs(number)), precision, '0', false);
+        number = Math.round(number - (number % 1))
+        prefix = number < 0 ? '-' : positiveNumberPrefix
+        value = prefix + _pad(String(Math.abs(number)), precision, '0', false)
 
         if (leftJustify && padChar === '0') {
           // can't right-pad 0s on integers
-          padChar = ' ';
+          padChar = ' '
         }
-        return justify(value, prefix, leftJustify, minWidth, padChar);
+        return justify(value, prefix, leftJustify, minWidth, padChar)
       case 'e':
       case 'E':
       case 'f': // @todo: Should handle locales (as per setlocale)
       case 'F':
       case 'g':
       case 'G':
-        number = +value;
-        prefix = number < 0 ? '-' : positiveNumberPrefix;
-        method = ['toExponential', 'toFixed', 'toPrecision']['efg'.indexOf(specifier.toLowerCase())];
-        textTransform = ['toString', 'toUpperCase']['eEfFgG'.indexOf(specifier) % 2];
-        value = prefix + Math.abs(number)[method](precision);
-        return justify(value, prefix, leftJustify, minWidth, padChar)[textTransform]();
+        number = +value
+        prefix = number < 0 ? '-' : positiveNumberPrefix
+        method = ['toExponential', 'toFixed', 'toPrecision']['efg'.indexOf(specifier.toLowerCase())]
+        textTransform = ['toString', 'toUpperCase']['eEfFgG'.indexOf(specifier) % 2]
+        value = prefix + Math.abs(number)[method](precision)
+        return justify(value, prefix, leftJustify, minWidth, padChar)[textTransform]()
       default:
         // unknown specifier, consume that char and return empty
-        return '';
+        return ''
     }
-  };
+  }
 
   try {
-    return format.replace(regex, doFormat);
-  } catch (err) {
-    return false;
+    return format.replace(regex, doFormat)
+  } catch (_err) {
+    return false
   }
-};
-//# sourceMappingURL=sprintf.js.map
+}