<?php

[0] Fix | Delete

[1] Fix | Delete

namespace WPForms\Helpers;

[2] Fix | Delete

[3] Fix | Delete

use BadFunctionCallException;

[4] Fix | Delete

[5] Fix | Delete

/**

[6] Fix | Delete

* Chain monad, useful for chaining a certain array or string related functions.

[7] Fix | Delete

*

[8] Fix | Delete

* @since 1.5.6

[9] Fix | Delete

*

[10] Fix | Delete

* @method Chain array_change_key_case()

[11] Fix | Delete

* @method Chain array_chunk()

[12] Fix | Delete

* @method Chain array_column()

[13] Fix | Delete

* @method Chain array_combine()

[14] Fix | Delete

* @method Chain array_count_values()

[15] Fix | Delete

* @method Chain array_diff_assoc()

[16] Fix | Delete

* @method Chain array_diff_key()

[17] Fix | Delete

* @method Chain array_diff_uassoc()

[18] Fix | Delete

* @method Chain array_diff_ukey()

[19] Fix | Delete

* @method Chain array_diff(array $var)

[20] Fix | Delete

* @method Chain array_fill_keys()

[21] Fix | Delete

* @method Chain array_fill()

[22] Fix | Delete

* @method Chain array_filter()

[23] Fix | Delete

* @method Chain array_flip()

[24] Fix | Delete

* @method Chain array_intersect_assoc()

[25] Fix | Delete

* @method Chain array_intersect_key()

[26] Fix | Delete

* @method Chain array_intersect_uassoc()

[27] Fix | Delete

* @method Chain array_intersect_ukey()

[28] Fix | Delete

* @method Chain array_intersect(array $var)

[29] Fix | Delete

* @method Chain array_key_first()

[30] Fix | Delete

* @method Chain array_key_last()

[31] Fix | Delete

* @method Chain array_keys()

[32] Fix | Delete

* @method Chain array_map()

[33] Fix | Delete

* @method Chain array_merge_recursive()

[34] Fix | Delete

* @method Chain array_merge(array $var)

[35] Fix | Delete

* @method Chain array_pad()

[36] Fix | Delete

* @method Chain array_pop()

[37] Fix | Delete

* @method Chain array_product()

[38] Fix | Delete

* @method Chain array_rand()

[39] Fix | Delete

* @method Chain array_reduce()

[40] Fix | Delete

* @method Chain array_replace_recursive()

[41] Fix | Delete

* @method Chain array_replace()

[42] Fix | Delete

* @method Chain array_reverse()

[43] Fix | Delete

* @method Chain array_shift()

[44] Fix | Delete

* @method Chain array_slice()

[45] Fix | Delete

* @method Chain array_splice()

[46] Fix | Delete

* @method Chain array_sum()

[47] Fix | Delete

* @method Chain array_udiff_assoc()

[48] Fix | Delete

* @method Chain array_udiff_uassoc()

[49] Fix | Delete

* @method Chain array_udiff()

[50] Fix | Delete

* @method Chain array_uintersect_assoc()

[51] Fix | Delete

* @method Chain array_uintersect_uassoc()

[52] Fix | Delete

* @method Chain array_uintersect()

[53] Fix | Delete

* @method Chain array_unique()

[54] Fix | Delete

* @method Chain array_values()

[55] Fix | Delete

* @method Chain count()

[56] Fix | Delete

* @method Chain current()

[57] Fix | Delete

* @method Chain end()

[58] Fix | Delete

* @method Chain key()

[59] Fix | Delete

* @method Chain next()

[60] Fix | Delete

* @method Chain prev()

[61] Fix | Delete

* @method Chain range()

[62] Fix | Delete

* @method Chain reset()

[63] Fix | Delete

* @method Chain ltrim()

[64] Fix | Delete

* @method Chain rtrim()

[65] Fix | Delete

* @method Chain md5()

[66] Fix | Delete

* @method Chain str_getcsv()

[67] Fix | Delete

* @method Chain str_ireplace()

[68] Fix | Delete

* @method Chain str_pad()

[69] Fix | Delete

* @method Chain str_repeat()

[70] Fix | Delete

* @method Chain str_rot13()

[71] Fix | Delete

* @method Chain str_shuffle()

[72] Fix | Delete

* @method Chain str_split()

[73] Fix | Delete

* @method Chain str_word_count()

[74] Fix | Delete

* @method Chain strcasecmp()

[75] Fix | Delete

* @method Chain strchr()

[76] Fix | Delete

* @method Chain strcmp()

[77] Fix | Delete

* @method Chain strcoll()

[78] Fix | Delete

* @method Chain strcspn()

[79] Fix | Delete

* @method Chain strip_tags()

[80] Fix | Delete

* @method Chain stripcslashes()

[81] Fix | Delete

* @method Chain stripos()

[82] Fix | Delete

* @method Chain stripslashes()

[83] Fix | Delete

* @method Chain stristr()

[84] Fix | Delete

* @method Chain strlen()

[85] Fix | Delete

* @method Chain strnatcasecmp()

[86] Fix | Delete

* @method Chain strnatcmp()

[87] Fix | Delete

* @method Chain strncasecmp()

[88] Fix | Delete

* @method Chain strncmp()

[89] Fix | Delete

* @method Chain strpbrk()

[90] Fix | Delete

* @method Chain strpos()

[91] Fix | Delete

* @method Chain strrchr()

[92] Fix | Delete

* @method Chain strrev()

[93] Fix | Delete

* @method Chain strripos()

[94] Fix | Delete

* @method Chain strrpos()

[95] Fix | Delete

* @method Chain strspn()

[96] Fix | Delete

* @method Chain strstr()

[97] Fix | Delete

* @method Chain strtok()

[98] Fix | Delete

* @method Chain strtolower()

[99] Fix | Delete

* @method Chain strtoupper()

[100] Fix | Delete

* @method Chain strtr()

[101] Fix | Delete

* @method Chain substr_compare()

[102] Fix | Delete

* @method Chain substr_count()

[103] Fix | Delete

* @method Chain substr_replace()

[104] Fix | Delete

* @method Chain substr()

[105] Fix | Delete

* @method Chain trim()

[106] Fix | Delete

* @method Chain ucfirst()

[107] Fix | Delete

* @method Chain ucwords()

[108] Fix | Delete

* @method Chain vfprintf()

[109] Fix | Delete

* @method Chain vprintf()

[110] Fix | Delete

* @method Chain vsprintf()

[111] Fix | Delete

* @method Chain wordwrap()

[112] Fix | Delete

*/

[113] Fix | Delete

class Chain {

[114] Fix | Delete

[115] Fix | Delete

/**

[116] Fix | Delete

* Current value.

[117] Fix | Delete

*

[118] Fix | Delete

* @since 1.5.6

[119] Fix | Delete

*

[120] Fix | Delete

* @var mixed

[121] Fix | Delete

*/

[122] Fix | Delete

private $value;

[123] Fix | Delete

[124] Fix | Delete

/**

[125] Fix | Delete

* Class constructor.

[126] Fix | Delete

*

[127] Fix | Delete

* @since 1.5.6

[128] Fix | Delete

*

[129] Fix | Delete

* @param mixed $value Current value to start working with.

[130] Fix | Delete

*/

[131] Fix | Delete

public function __construct( $value ) {

[132] Fix | Delete

[133] Fix | Delete

$this->value = $value;

[134] Fix | Delete

}

[135] Fix | Delete

[136] Fix | Delete

/**

[137] Fix | Delete

* Bind some function to value.

[138] Fix | Delete

*

[139] Fix | Delete

* @since 1.5.6

[140] Fix | Delete

*

[141] Fix | Delete

* @param mixed $fn Some function.

[142] Fix | Delete

*

[143] Fix | Delete

* @return Chain

[144] Fix | Delete

*/

[145] Fix | Delete

public function bind( $fn ) {

[146] Fix | Delete

[147] Fix | Delete

$this->value = $fn( $this->value );

[148] Fix | Delete

[149] Fix | Delete

return $this;

[150] Fix | Delete

}

[151] Fix | Delete

[152] Fix | Delete

/**

[153] Fix | Delete

* Get value.

[154] Fix | Delete

*

[155] Fix | Delete

* @since 1.5.6

[156] Fix | Delete

*

[157] Fix | Delete

* @return mixed

[158] Fix | Delete

*/

[159] Fix | Delete

public function value() {

[160] Fix | Delete

[161] Fix | Delete

return $this->value;

[162] Fix | Delete

}

[163] Fix | Delete

[164] Fix | Delete

/**

[165] Fix | Delete

* Magic call.

[166] Fix | Delete

*

[167] Fix | Delete

* @since 1.5.6

[168] Fix | Delete

*

[169] Fix | Delete

* @param string $name Method name.

[170] Fix | Delete

* @param array $params Parameters.

[171] Fix | Delete

*

[172] Fix | Delete

* @throws BadFunctionCallException Invalid function is called.

[173] Fix | Delete

*

[174] Fix | Delete

* @return Chain

[175] Fix | Delete

*/

[176] Fix | Delete

public function __call( $name, $params ) {

[177] Fix | Delete

[178] Fix | Delete

if ( in_array( $name, $this->allowed_methods(), true ) ) {

[179] Fix | Delete

[180] Fix | Delete

$params = $params === null ? [] : $params;

[181] Fix | Delete

[182] Fix | Delete

array_unshift( $params, $this->value );

[183] Fix | Delete

[184] Fix | Delete

$this->value = call_user_func_array( $name, array_values( $params ) );

[185] Fix | Delete

[186] Fix | Delete

return $this;

[187] Fix | Delete

}

[188] Fix | Delete

[189] Fix | Delete

throw new BadFunctionCallException( esc_html( "Provided function { $name } is not allowed. See Chain::allowed_methods()." ) );

[190] Fix | Delete

}

[191] Fix | Delete

[192] Fix | Delete

/**

[193] Fix | Delete

* Join array elements with a string.

[194] Fix | Delete

*

[195] Fix | Delete

* @since 1.5.6

[196] Fix | Delete

*

[197] Fix | Delete

* @param string $glue Defaults to an empty string.

[198] Fix | Delete

*

[199] Fix | Delete

* @return Chain

[200] Fix | Delete

*/

[201] Fix | Delete

public function implode( $glue = '' ) {

[202] Fix | Delete

[203] Fix | Delete

$this->value = implode( $glue, $this->value );

[204] Fix | Delete

[205] Fix | Delete

return $this;

[206] Fix | Delete

}

[207] Fix | Delete

[208] Fix | Delete

/**

[209] Fix | Delete

* Split a string by a string.

[210] Fix | Delete

*

[211] Fix | Delete

* @since 1.5.6

[212] Fix | Delete

*

[213] Fix | Delete

* @param string $delimiter The boundary string.

[214] Fix | Delete

*

[215] Fix | Delete

* @return Chain

[216] Fix | Delete

*/

[217] Fix | Delete

public function explode( $delimiter ) {

[218] Fix | Delete

[219] Fix | Delete

$this->value = explode( $delimiter, $this->value );

[220] Fix | Delete

[221] Fix | Delete

return $this;

[222] Fix | Delete

}

[223] Fix | Delete

[224] Fix | Delete

/**

[225] Fix | Delete

* Apply the callback to the elements of the given arrays.

[226] Fix | Delete

*

[227] Fix | Delete

* @since 1.5.6

[228] Fix | Delete

*

[229] Fix | Delete

* @param callable $cb Callback.

[230] Fix | Delete

*

[231] Fix | Delete

* @return Chain

[232] Fix | Delete

*/

[233] Fix | Delete

public function map( $cb ) {

[234] Fix | Delete

[235] Fix | Delete

$this->value = array_map( $cb, $this->value );

[236] Fix | Delete

[237] Fix | Delete

return $this;

[238] Fix | Delete

}

[239] Fix | Delete

[240] Fix | Delete

/**

[241] Fix | Delete

* Pop array.

[242] Fix | Delete

*

[243] Fix | Delete

* @since 1.5.6

[244] Fix | Delete

*

[245] Fix | Delete

* @return Chain

[246] Fix | Delete

*/

[247] Fix | Delete

public function pop() {

[248] Fix | Delete

[249] Fix | Delete

$this->value = array_pop( $this->value );

[250] Fix | Delete

[251] Fix | Delete

return $this;

[252] Fix | Delete

}

[253] Fix | Delete

[254] Fix | Delete

/**

[255] Fix | Delete

* Run first or second callback based on a condition.

[256] Fix | Delete

*

[257] Fix | Delete

* @since 1.5.6

[258] Fix | Delete

*

[259] Fix | Delete

* @param callable $condition Condition function.

[260] Fix | Delete

* @param callable $true_result If condition will return true we run this function.

[261] Fix | Delete

* @param callable $false_result If condition will return false we run this function.

[262] Fix | Delete

*

[263] Fix | Delete

* @return Chain

[264] Fix | Delete

*/

[265] Fix | Delete

public function iif( $condition, $true_result, $false_result = null ) {

[266] Fix | Delete

[267] Fix | Delete

if ( ! is_callable( $false_result ) ) {

[268] Fix | Delete

$false_result = function() {

[269] Fix | Delete

return '';

[270] Fix | Delete

};

[271] Fix | Delete

}

[272] Fix | Delete

$this->value = array_map(

[273] Fix | Delete

function( $el ) use ( $condition, $true_result, $false_result ) {

[274] Fix | Delete

if ( call_user_func( $condition, $el ) ) {

[275] Fix | Delete

return call_user_func( $true_result, $el );

[276] Fix | Delete

}

[277] Fix | Delete

return call_user_func( $false_result, $el );

[278] Fix | Delete

},

[279] Fix | Delete

$this->value

[280] Fix | Delete

);

[281] Fix | Delete

[282] Fix | Delete

return $this;

[283] Fix | Delete

}

[284] Fix | Delete

[285] Fix | Delete

/**

[286] Fix | Delete

* All allowed methods to work with data.

[287] Fix | Delete

*

[288] Fix | Delete

* @since 1.5.6

[289] Fix | Delete

*

[290] Fix | Delete

* @return array

[291] Fix | Delete

*/

[292] Fix | Delete

public function allowed_methods() {

[293] Fix | Delete

[294] Fix | Delete

return [

[295] Fix | Delete

'array_change_key_case',

[296] Fix | Delete

'array_chunk',

[297] Fix | Delete

'array_column',

[298] Fix | Delete

'array_combine',

[299] Fix | Delete

'array_count_values',

[300] Fix | Delete

'array_diff_assoc',

[301] Fix | Delete

'array_diff_key',

[302] Fix | Delete

'array_diff_uassoc',

[303] Fix | Delete

'array_diff_ukey',

[304] Fix | Delete

'array_diff',

[305] Fix | Delete

'array_fill_keys',

[306] Fix | Delete

'array_fill',

[307] Fix | Delete

'array_filter',

[308] Fix | Delete

'array_flip',

[309] Fix | Delete

'array_intersect_assoc',

[310] Fix | Delete

'array_intersect_key',

[311] Fix | Delete

'array_intersect_uassoc',

[312] Fix | Delete

'array_intersect_ukey',

[313] Fix | Delete

'array_intersect',

[314] Fix | Delete

'array_key_first',

[315] Fix | Delete

'array_key_last',

[316] Fix | Delete

'array_keys',

[317] Fix | Delete

'array_map',

[318] Fix | Delete

'array_merge_recursive',

[319] Fix | Delete

'array_merge',

[320] Fix | Delete

'array_pad',

[321] Fix | Delete

'array_pop',

[322] Fix | Delete

'array_product',

[323] Fix | Delete

'array_rand',

[324] Fix | Delete

'array_reduce',

[325] Fix | Delete

'array_replace_recursive',

[326] Fix | Delete

'array_replace',

[327] Fix | Delete

'array_reverse',

[328] Fix | Delete

'array_shift',

[329] Fix | Delete

'array_slice',

[330] Fix | Delete

'array_splice',

[331] Fix | Delete

'array_sum',

[332] Fix | Delete

'array_udiff_assoc',

[333] Fix | Delete

'array_udiff_uassoc',

[334] Fix | Delete

'array_udiff',

[335] Fix | Delete

'array_uintersect_assoc',

[336] Fix | Delete

'array_uintersect_uassoc',

[337] Fix | Delete

'array_uintersect',

[338] Fix | Delete

'array_unique',

[339] Fix | Delete

'array_values',

[340] Fix | Delete

'count',

[341] Fix | Delete

'current',

[342] Fix | Delete

'end',

[343] Fix | Delete

'key',

[344] Fix | Delete

'next',

[345] Fix | Delete

'prev',

[346] Fix | Delete

'range',

[347] Fix | Delete

'reset',

[348] Fix | Delete

'implode',

[349] Fix | Delete

'ltrim',

[350] Fix | Delete

'rtrim',

[351] Fix | Delete

'md5',

[352] Fix | Delete

'str_getcsv',

[353] Fix | Delete

'str_ireplace',

[354] Fix | Delete

'str_pad',

[355] Fix | Delete

'str_repeat',

[356] Fix | Delete

'str_rot13',

[357] Fix | Delete

'str_shuffle',

[358] Fix | Delete

'str_split',

[359] Fix | Delete

'str_word_count',

[360] Fix | Delete

'strcasecmp',

[361] Fix | Delete

'strchr',

[362] Fix | Delete

'strcmp',

[363] Fix | Delete

'strcoll',

[364] Fix | Delete

'strcspn',

[365] Fix | Delete

'strip_tags',

[366] Fix | Delete

'stripcslashes',

[367] Fix | Delete

'stripos',

[368] Fix | Delete

'stripslashes',

[369] Fix | Delete

'stristr',

[370] Fix | Delete

'strlen',

[371] Fix | Delete

'strnatcasecmp',

[372] Fix | Delete

'strnatcmp',

[373] Fix | Delete

'strncasecmp',

[374] Fix | Delete

'strncmp',

[375] Fix | Delete

'strpbrk',

[376] Fix | Delete

'strpos',

[377] Fix | Delete

'strrchr',

[378] Fix | Delete

'strrev',

[379] Fix | Delete

'strripos',

[380] Fix | Delete

'strrpos',

[381] Fix | Delete

'strspn',

[382] Fix | Delete

'strstr',

[383] Fix | Delete

'strtok',

[384] Fix | Delete

'strtolower',

[385] Fix | Delete

'strtoupper',

[386] Fix | Delete

'strtr',

[387] Fix | Delete

'substr_compare',

[388] Fix | Delete

'substr_count',

[389] Fix | Delete

'substr_replace',

[390] Fix | Delete

'substr',

[391] Fix | Delete

'trim',

[392] Fix | Delete

'ucfirst',

[393] Fix | Delete

'ucwords',

[394] Fix | Delete

'vfprintf',

[395] Fix | Delete

'vprintf',

[396] Fix | Delete

'vsprintf',

[397] Fix | Delete

'wordwrap',

[398] Fix | Delete

];

[399] Fix | Delete

}

[400] Fix | Delete

[401] Fix | Delete

/**

[402] Fix | Delete

* Create myself.

[403] Fix | Delete

*

[404] Fix | Delete

* @since 1.5.6

[405] Fix | Delete

*

[406] Fix | Delete

* @param mixed $value Current.

[407] Fix | Delete

*

[408] Fix | Delete

* @return Chain

[409] Fix | Delete

*/

[410] Fix | Delete

public static function of( $value = null ) {

[411] Fix | Delete

[412] Fix | Delete

return new self( $value );

[413] Fix | Delete

}

[414] Fix | Delete

}

[415] Fix | Delete

[416] Fix | Delete