/home/techb158/primomovers.ca/wp-content/plugins/polylang-pro/include
Edit: /home/techb158/primomovers.ca/wp-content/plugins/polylang-pro/include/format-util.php (2797B)
*/
private $patterns = array();
/**
* Filters the given list to return only the values whose the key or value matches the given format.
*
* @since 3.6
*
* @param array|Traversable $list An list with keys or values to match against `$format`.
* @param string $format A format, where `*` means "any characters" (`.*`), unless escaped.
* @param string $mode Optional. Tell if we should filter the keys or values from `$list`.
* Possible values are `'use_keys'` and `'use_values'`. Default is `'use_keys'`.
* @return array
*
* @template TArrayValue
* @phpstan-param ($mode is 'use_keys' ? array
|Traversable : array|Traversable) $list
* @phpstan-param 'use_keys'|'values' $mode
* @phpstan-return ($mode is 'use_keys' ? array : array)
*/
public function filter_list( $list, string $format, string $mode = 'use_keys' ): array {
$filter = function ( $key ) use ( $format ) {
return $this->matches( (string) $key, $format );
};
if ( ! is_array( $list ) ) {
$list = iterator_to_array( $list );
}
if ( 'use_values' === $mode ) {
return array_filter( $list, $filter );
}
return array_filter( $list, $filter, ARRAY_FILTER_USE_KEY );
}
/**
* Tells if the given string matches the given format.
*
* @since 3.6
*
* @param string $key A string to test.
* @param string $format A format, where `*` means "any characters" (`.*`), unless escaped.
* @return bool
*/
public function matches( string $key, string $format ): bool {
if ( strpos( $format, '*' ) === false ) {
return $key === $format;
}
if ( '*' === $format ) {
return true;
}
if ( empty( $this->patterns[ $format ] ) ) {
$pattern = addcslashes( $format, '.+?[^]$(){}=!<>|:-#/' ); // Escape regular expression characters (list from `preg_quote()` but `*` and `\` are ignored).
$pattern = preg_replace(
array(
'/\\\(?!\*)/', // Escape `\` characters except if followed by `*`.
'/(?patterns[ $format ] = $pattern;
} else {
$pattern = $this->patterns[ $format ];
}
return (bool) preg_match( "/^{$pattern}$/", $key );
}
}