<?php
namespace WPForms\Helpers;
use BadFunctionCallException;
/**
* Chain monad, useful for chaining a certain array or string related functions.
*
* @since 1.5.6
*
* @method Chain array_change_key_case()
* @method Chain array_chunk()
* @method Chain array_column()
* @method Chain array_combine()
* @method Chain array_count_values()
* @method Chain array_diff_assoc()
* @method Chain array_diff_key()
* @method Chain array_diff_uassoc()
* @method Chain array_diff_ukey()
* @method Chain array_diff(array $var)
* @method Chain array_fill_keys()
* @method Chain array_fill()
* @method Chain array_filter()
* @method Chain array_flip()
* @method Chain array_intersect_assoc()
* @method Chain array_intersect_key()
* @method Chain array_intersect_uassoc()
* @method Chain array_intersect_ukey()
* @method Chain array_intersect(array $var)
* @method Chain array_key_first()
* @method Chain array_key_last()
* @method Chain array_keys()
* @method Chain array_map()
* @method Chain array_merge_recursive()
* @method Chain array_merge(array $var)
* @method Chain array_pad()
* @method Chain array_pop()
* @method Chain array_product()
* @method Chain array_rand()
* @method Chain array_reduce()
* @method Chain array_replace_recursive()
* @method Chain array_replace()
* @method Chain array_reverse()
* @method Chain array_shift()
* @method Chain array_slice()
* @method Chain array_splice()
* @method Chain array_sum()
* @method Chain array_udiff_assoc()
* @method Chain array_udiff_uassoc()
* @method Chain array_udiff()
* @method Chain array_uintersect_assoc()
* @method Chain array_uintersect_uassoc()
* @method Chain array_uintersect()
* @method Chain array_unique()
* @method Chain array_values()
* @method Chain count()
* @method Chain current()
* @method Chain end()
* @method Chain key()
* @method Chain next()
* @method Chain prev()
* @method Chain range()
* @method Chain reset()
* @method Chain ltrim()
* @method Chain rtrim()
* @method Chain md5()
* @method Chain str_getcsv()
* @method Chain str_ireplace()
* @method Chain str_pad()
* @method Chain str_repeat()
* @method Chain str_rot13()
* @method Chain str_shuffle()
* @method Chain str_split()
* @method Chain str_word_count()
* @method Chain strcasecmp()
* @method Chain strchr()
* @method Chain strcmp()
* @method Chain strcoll()
* @method Chain strcspn()
* @method Chain strip_tags()
* @method Chain stripcslashes()
* @method Chain stripos()
* @method Chain stripslashes()
* @method Chain stristr()
* @method Chain strlen()
* @method Chain strnatcasecmp()
* @method Chain strnatcmp()
* @method Chain strncasecmp()
* @method Chain strncmp()
* @method Chain strpbrk()
* @method Chain strpos()
* @method Chain strrchr()
* @method Chain strrev()
* @method Chain strripos()
* @method Chain strrpos()
* @method Chain strspn()
* @method Chain strstr()
* @method Chain strtok()
* @method Chain strtolower()
* @method Chain strtoupper()
* @method Chain strtr()
* @method Chain substr_compare()
* @method Chain substr_count()
* @method Chain substr_replace()
* @method Chain substr()
* @method Chain trim()
* @method Chain ucfirst()
* @method Chain ucwords()
* @method Chain vfprintf()
* @method Chain vprintf()
* @method Chain vsprintf()
* @method Chain wordwrap()
*/
class Chain {
/**
* Current value.
*
* @since 1.5.6
*
* @var mixed
*/
private $value;
/**
* Class constructor.
*
* @since 1.5.6
*
* @param mixed $value Current value to start working with.
*/
public function __construct( $value ) {
$this->value = $value;
}
/**
* Bind some function to value.
*
* @since 1.5.6
*
* @param mixed $fn Some function.
*
* @return Chain
*/
public function bind( $fn ) {
$this->value = $fn( $this->value );
return $this;
}
/**
* Get value.
*
* @since 1.5.6
*
* @return mixed
*/
public function value() {
return $this->value;
}
/**
* Magic call.
*
* @since 1.5.6
*
* @param string $name Method name.
* @param array $params Parameters.
*
* @throws BadFunctionCallException Invalid function is called.
*
* @return Chain
*/
public function __call( $name, $params ) {
if ( in_array( $name, $this->allowed_methods(), true ) ) {
$params = $params === null ? [] : $params;
array_unshift( $params, $this->value );
$this->value = call_user_func_array( $name, array_values( $params ) );
return $this;
}
throw new BadFunctionCallException( esc_html( "Provided function { $name } is not allowed. See Chain::allowed_methods()." ) );
}
/**
* Join array elements with a string.
*
* @since 1.5.6
*
* @param string $glue Defaults to an empty string.
*
* @return Chain
*/
public function implode( $glue = '' ) {
$this->value = implode( $glue, $this->value );
return $this;
}
/**
* Split a string by a string.
*
* @since 1.5.6
*
* @param string $delimiter The boundary string.
*
* @return Chain
*/
public function explode( $delimiter ) {
$this->value = explode( $delimiter, $this->value );
return $this;
}
/**
* Apply the callback to the elements of the given arrays.
*
* @since 1.5.6
*
* @param callable $cb Callback.
*
* @return Chain
*/
public function map( $cb ) {
$this->value = array_map( $cb, $this->value );
return $this;
}
/**
* Pop array.
*
* @since 1.5.6
*
* @return Chain
*/
public function pop() {
$this->value = array_pop( $this->value );
return $this;
}
/**
* Run first or second callback based on a condition.
*
* @since 1.5.6
*
* @param callable $condition Condition function.
* @param callable $true_result If condition will return true we run this function.
* @param callable $false_result If condition will return false we run this function.
*
* @return Chain
*/
public function iif( $condition, $true_result, $false_result = null ) {
if ( ! is_callable( $false_result ) ) {
$false_result = function() {
return '';
};
}
$this->value = array_map(
function( $el ) use ( $condition, $true_result, $false_result ) {
if ( call_user_func( $condition, $el ) ) {
return call_user_func( $true_result, $el );
}
return call_user_func( $false_result, $el );
},
$this->value
);
return $this;
}
/**
* All allowed methods to work with data.
*
* @since 1.5.6
*
* @return array
*/
public function allowed_methods() {
return [
'array_change_key_case',
'array_chunk',
'array_column',
'array_combine',
'array_count_values',
'array_diff_assoc',
'array_diff_key',
'array_diff_uassoc',
'array_diff_ukey',
'array_diff',
'array_fill_keys',
'array_fill',
'array_filter',
'array_flip',
'array_intersect_assoc',
'array_intersect_key',
'array_intersect_uassoc',
'array_intersect_ukey',
'array_intersect',
'array_key_first',
'array_key_last',
'array_keys',
'array_map',
'array_merge_recursive',
'array_merge',
'array_pad',
'array_pop',
'array_product',
'array_rand',
'array_reduce',
'array_replace_recursive',
'array_replace',
'array_reverse',
'array_shift',
'array_slice',
'array_splice',
'array_sum',
'array_udiff_assoc',
'array_udiff_uassoc',
'array_udiff',
'array_uintersect_assoc',
'array_uintersect_uassoc',
'array_uintersect',
'array_unique',
'array_values',
'count',
'current',
'end',
'key',
'next',
'prev',
'range',
'reset',
'implode',
'ltrim',
'rtrim',
'md5',
'str_getcsv',
'str_ireplace',
'str_pad',
'str_repeat',
'str_rot13',
'str_shuffle',
'str_split',
'str_word_count',
'strcasecmp',
'strchr',
'strcmp',
'strcoll',
'strcspn',
'strip_tags',
'stripcslashes',
'stripos',
'stripslashes',
'stristr',
'strlen',
'strnatcasecmp',
'strnatcmp',
'strncasecmp',
'strncmp',
'strpbrk',
'strpos',
'strrchr',
'strrev',
'strripos',
'strrpos',
'strspn',
'strstr',
'strtok',
'strtolower',
'strtoupper',
'strtr',
'substr_compare',
'substr_count',
'substr_replace',
'substr',
'trim',
'ucfirst',
'ucwords',
'vfprintf',
'vprintf',
'vsprintf',
'wordwrap',
];
}
/**
* Create myself.
*
* @since 1.5.6
*
* @param mixed $value Current.
*
* @return Chain
*/
public static function of( $value = null ) {
return new self( $value );
}
}