|
| static | counterToBase64 (int $n) |
| | Convert a counter to a Base64 encoded string.
|
| |
| static | jsonEncode ( $o) |
| | FIXME: Core has FormatJson::encode that does a more comprehensive job.
|
| |
| static | jsonDecode (string $str, bool $assoc=true) |
| | FIXME: Core has FormatJson::parse that does a more comprehensive job json_decode wrapper function.
|
| |
| static | makeSet (array $a) |
| | Convert array to associative array usable as a read-only Set.
|
| |
| static | lastItem (array $a) |
| | Helper to get last item of the array.
|
| |
| static | pushArray (array &$dest, array $source) |
| | Append an array to an accumulator using the most efficient method available.
|
| |
| static | safeSubstr (string $s, int $start, ?int $length=null, bool $checkEntireString=false) |
| | Return a substring, asserting that it is valid UTF-8.
|
| |
| static | assertValidUTF8 (string $s) |
| | Helper for verifying a valid UTF-8 encoding.
|
| |
| static | reStrip (string $re, ?string $newDelimiter=null) |
| | Helper for joining pieces of regular expressions together.
|
| |
| static | encodeURIComponent (string $str) |
| | JS-compatible encodeURIComponent function FIXME: See T221147 (for a post-port update)
|
| |
| static | arrayToObject ( $array) |
| | Convert an array to an object.
|
| |
| static | sortArray (&$array) |
| | Sort keys in an array, recursively, for better reproducibility.
|
| |
| static | iterable_to_array (iterable $iterable) |
| | Convert an iterable to an array.
|
| |
| static | unreachable (string $reason="should never happen") |
| | Indicate that the code which calls this function is intended to be unreachable.
|
| |
| static | stripPrefix ( $subject, $prefix) |
| | If a string starts with a given prefix, remove the prefix.
|
| |
| static | stripSuffix ( $subject, $suffix) |
| | If a string ends with a given suffix, remove the suffix.
|
| |
| static Wikimedia\Parsoid\Utils\PHPUtils::arrayToObject |
( |
| $array | ) |
|
|
static |
Convert an array to an object.
Workaround for T228346 / https://bugs.php.net/bug.php?id=78379
PHP 7 introduced "efficient" casting of arrays to objects by taking a reference instead of duplicating the array. However, this was not properly accounted for in the garbage collector. The garbage collector would free the array while it was still referred to by live objects.
The workaround here is to manually duplicate the array. It's not necessary to do a deep copy since only the top-level array is referenced by the new object.
It's only necessary to call this for potentially shared arrays, such as compile-time constants. Arrays that have a reference count of 1 can be cast to objects in the usual way. For example, array literals containing variables are typically unshared.
- Parameters
-
- Returns
- \stdClass
| static Wikimedia\Parsoid\Utils\PHPUtils::safeSubstr |
( |
string | $s, |
|
|
int | $start, |
|
|
?int | $length = null, |
|
|
bool | $checkEntireString = false ) |
|
static |
Return a substring, asserting that it is valid UTF-8.
By default we assume the full string was valid UTF-8, which allows us to look at the first and last bytes to make this check. You can check the entire string if you are feeling paranoid; it will take O(N) time (where N is the length of the substring) but so does the substring operation.
If the substring would start beyond the end of the string or end before the start of the string, then this function will return the empty string (as would JavaScript); note that the native substr would return false in this case.
Using this helper instead of native substr is useful during the PHP port to verify that we don't break up Unicode codepoints by the switch from JavaScript UCS-2 offsets to PHP UTF-8 byte offsets.
- Parameters
-
| string | $s | The (sub)string to check |
| int | $start | The starting offset (in bytes). If negative, the offset is counted from the end of the string. |
| ?int | $length | (optional) The maximum length of the returned string. If negative, the end position is counted from the end of the string. |
| bool | $checkEntireString | Whether to do a slower verification of the entire string, not just the edges. Defaults to false. |
- Returns
- string The checked substring
| static Wikimedia\Parsoid\Utils\PHPUtils::stripPrefix |
( |
| $subject, |
|
|
| $prefix ) |
|
static |
If a string starts with a given prefix, remove the prefix.
Otherwise, return the original string. Like preg_replace( "/^$prefix/", '', $subject ) except about 1.14x faster in the replacement case and 2x faster in the no-op case.
Note: adding type declarations to the parameters adds an overhead of 3%. The benchmark above was without type declarations.
- Parameters
-
| string | $subject | |
| string | $prefix | |
- Returns
- string
1.10.0