,error_levels?:string[]}> */ public function providerValidCodeParse(): iterable { return [ 'arrayFilter' => [ ' rand(0, 10), "b" => rand(0, 10), "c" => null]); $e = array_filter( ["a" => rand(0, 10), "b" => rand(0, 10), "c" => null], function(?int $i): bool { return true; } );', 'assertions' => [ '$d' => 'array{a?: int<1, 10>, b?: int<1, 10>}', '$e' => 'array|null>', ], ], 'positiveIntArrayFilter' => [ ' $d * @param int<1,12> $f * @psalm-return array{a: numeric, b?: int, c: positive-int, d?: int<0, 12>, f: int<1,12>} */ function makeAList($a, int $anyInt, int $positiveOne, int $d, int $f): array { return array_filter(["a" => "1", "b" => $anyInt, "c" => $positiveOne, "d" => $d, "f" => $f]); }' ], 'arrayFilterAdvanced' => [ ' 5, "b" => 12, "c" => null], function(?int $val, string $key): bool { return true; }, ARRAY_FILTER_USE_BOTH); $g = array_filter(["a" => 5, "b" => 12, "c" => null], function(string $val): bool { return true; }, ARRAY_FILTER_USE_KEY); $bar = "bar"; $foo = [ $bar => function (): string { return "baz"; }, ]; $foo = array_filter( $foo, function (string $key): bool { return $key === "bar"; }, ARRAY_FILTER_USE_KEY );', 'assertions' => [ '$f' => 'array', '$g' => 'array', ], ], 'arrayFilterIgnoreNullable' => [ ' */ public function getRows() : array { return [new self, null]; } public function filter() : void { $arr = array_filter( static::getRows(), function (self $row) : bool { return is_a($row, static::class); } ); } }', 'assertions' => [], 'error_levels' => ['PossiblyInvalidArgument'], ], 'arrayFilterAllowTrim' => [ ' [ ' [ ' $a * @return array */ function foo(array $a) : array { return array_filter($a, "is_object"); }', ], 'arrayFilterFleshOutType' => [ ' $statusList */ $statusList = [Baz::STATUS_FOO, Baz::STATUS_QUX]; $statusList = array_filter($statusList, [Baz::class, "isStatus"]);' ], 'arrayKeysNonEmpty' => [ ' 1, "b" => 2]);', 'assertions' => [ '$a' => 'non-empty-list', ], ], 'arrayKeysMixed' => [ ' 5]; $a = array_keys($b);', 'assertions' => [ '$a' => 'list', ], 'error_levels' => ['MixedArgument'], ], 'arrayValues' => [ ' 1, "b" => 2]); $c = array_values(["a" => "hello", "b" => "jello"]);', 'assertions' => [ '$b' => 'non-empty-list', '$c' => 'non-empty-list', ], ], 'arrayCombine' => [ ' [ '$c' => 'false|non-empty-array', ], 'error_levels' => [], '7.4', ], 'arrayCombinePHP8' => [ ' [ '$c' => 'non-empty-array', ], 'error_levels' => [], '8.0', ], 'arrayCombineNotMatching' => [ ' [ '$c' => 'false|non-empty-array', ], 'error_levels' => [], '7.4', ], 'arrayCombineDynamicParams' => [ ' */ function getStrings(): array{ return []; } /** @return array */ function getInts(): array{ return []; } $c = array_combine(getStrings(), getInts());', 'assertions' => [ '$c' => 'array|false', ], ], 'arrayMergeIntArrays' => [ ' [ '$d' => 'array{0: string, 1: string, 2: string, 3: string, 4: int, 5: int, 6: int}', ], ], 'arrayMergePossiblyUndefined' => [ ' 5], $opts); }', ], 'arrayMergeListResultWithArray' => [ ' $list * @return list */ function bar(array $list) : array { return array_merge($list, ["test"]); }', ], 'arrayMergeListResultWithList' => [ ' $list * @return list */ function foo(array $list) : array { return array_merge($list, ["test"]); }', ], 'arrayMergeTypes' => [ ' [ ' [ '$d' => 'array{0: int, 1: int, 2: int, 3: string}', ], ], 'arrayReplacePossiblyUndefined' => [ ' 5], $opts); }', ], 'arrayReplaceListResultWithArray' => [ ' $list * @return list */ function bar(array $list) : array { return array_replace($list, ["test"]); }', ], 'arrayReplaceListResultWithList' => [ ' $list * @return list */ function foo(array $list) : array { return array_replace($list, ["test"]); }', ], 'arrayReplaceTypes' => [ ' [ ' 4]);', 'assertions' => [ '$d' => 'non-empty-array', ], ], 'arrayReverseDontPreserveKeyExplicitArg' => [ ' 4], false);', 'assertions' => [ '$d' => 'non-empty-array', ], ], 'arrayReversePreserveKey' => [ ' [ '$d' => 'non-empty-array', ], ], 'arrayDiff' => [ ' 5, "b" => 12], [5]);', 'assertions' => [ '$d' => 'array', ], ], 'arrayDiffIsVariadic' => [ ' [], ], 'arrayDiffKeyIsVariadic' => [ ' [], ], 'arrayDiffAssoc' => [ ' $a * @var array $b * @var array $c */ $r = array_diff_assoc($a, $b, $c);', 'assertions' => [ '$r' => 'array', ], ], 'arrayPopMixed' => [ ' 5, "c" => 6]; $a = array_pop($b);', 'assertions' => [ '$a' => 'mixed', '$b' => 'mixed', ], 'error_levels' => ['MixedAssignment', 'MixedArgument'], ], 'arrayPopNonEmpty' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if ($a) { $b = array_pop($a); } $c = array_pop($a);', 'assertions' => [ '$b' => 'int', '$c' => 'int|null', ], ], 'arrayPopNonEmptyAfterIsset' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (isset($a["a"])) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCount' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (count($a)) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayShiftNonEmptyList' => [ ' [ '|array{null} $arr * @return array */ function foo(array $arr) { array_shift($arr); return $arr; }' ], 'arrayPopNonEmptyAfterCountEqualsOne' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (count($a) === 1) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountSoftEqualsOne' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (count($a) == 1) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountGreaterThanOne' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (count($a) > 0) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountGreaterOrEqualsOne' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (count($a) >= 1) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountEqualsOneReversed' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (1 === count($a)) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountSoftEqualsOneReversed' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (1 == count($a)) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountGreaterThanOneReversed' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (0 < count($a)) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterCountGreatorOrEqualToOneReversed' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $b = 5; if (1 <= count($a)) { $b = array_pop($a); }', 'assertions' => [ '$b' => 'int', ], ], 'arrayNotEmptyArrayAfterCountLessThanEqualToOne' => [ ' */ $leftCount = [1, 2, 3]; if (count($leftCount) <= 1) { echo $leftCount[0]; } /** @var list */ $rightCount = [1, 2, 3]; if (1 >= count($rightCount)) { echo $rightCount[0]; }', ], 'arrayNotEmptyArrayAfterCountLessThanTwo' => [ ' */ $leftCount = [1, 2, 3]; if (count($leftCount) < 2) { echo $leftCount[0]; } /** @var list */ $rightCount = [1, 2, 3]; if (2 > count($rightCount)) { echo $rightCount[0]; }', ], 'arrayEmptyArrayAfterCountLessThanOne' => [ ' */ $leftCount = [1, 2, 3]; assert (count($leftCount) < 1); /** @var list */ $rightCount = [1, 2, 3]; assert (1 > count($rightCount));', 'assertions' => [ '$leftCount' => 'array', '$rightCount' => 'array', ], ], 'arrayEmptyArrayAfterCountLessThanEqualToZero' => [ ' */ $leftCount = [1, 2, 3]; assert (count($leftCount) <= 0); /** @var list */ $rightCount = [1, 2, 3]; assert (0 >= count($rightCount));', 'assertions' => [ '$leftCount' => 'array', '$rightCount' => 'array', ], ], 'arrayNotNonEmptyArrayAfterCountGreaterThanEqualToZero' => [ ' */ $leftCount = [1, 2, 3]; assert(count($leftCount) >= 0); /** @var list */ $rightCount = [1, 2, 3]; assert(0 <= count($rightCount));', 'assertions' => [ '$leftCount' => 'list', '$rightCount' => 'list', ], ], 'arrayNotNonEmptyArrayAfterCountGreaterThanMinusOne' => [ ' */ $leftCount = [1, 2, 3]; assert (count($leftCount) > -1); /** @var list */ $rightCount = [1, 2, 3]; assert (-1 < count($rightCount));', 'assertions' => [ '$leftCount' => 'list', '$rightCount' => 'list', ], ], 'arrayNonEmptyArrayAfterCountGreaterThanEqualToOne' => [ ' */ $leftCount = [1, 2, 3]; assert(count($leftCount) >= 1); /** @var list */ $rightCount = [1, 2, 3]; assert(1 <= count($rightCount));', 'assertions' => [ '$leftCount' => 'non-empty-list', '$rightCount' => 'non-empty-list', ], ], 'arrayNonEmptyArrayAfterCountGreaterThanZero' => [ ' */ $leftCount = [1, 2, 3]; assert (count($leftCount) > 0); /** @var list */ $rightCount = [1, 2, 3]; assert (0 < count($rightCount));', 'assertions' => [ '$leftCount' => 'non-empty-list', '$rightCount' => 'non-empty-list', ], ], 'arrayPopNonEmptyAfterArrayAddition' => [ ' */ $a = ["a" => 5, "b" => 6, "c" => 7]; $a["foo"] = 10; $b = array_pop($a);', 'assertions' => [ '$b' => 'int', ], ], 'arrayPopNonEmptyAfterMixedArrayAddition' => [ ' 5, "b" => 6, "c" => 7]; $a[] = "hello"; $b = array_pop($a);', 'assertions' => [ '$b' => 'mixed|string', ], 'error_levels' => [ 'MixedAssignment', ], ], 'uasort' => [ ' $b ? 1 : -1; } $manifest = ["a" => 1, "b" => 2]; uasort( $manifest, "foo" ); $emptyManifest = []; uasort( $emptyManifest, "foo" ); ', 'assertions' => [ '$manifest' => 'non-empty-array', '$emptyManifest' => 'array', ], ], 'uksort' => [ ' $b; } $array = ["b" => 1, "a" => 2]; uksort( $array, "foo" ); $emptyArray = []; uksort( $emptyArray, "foo" );', 'assertions' => [ '$array' => 'non-empty-array', '$emptyArray' => 'array', ], ], 'arrayMergeTKeyedArray' => [ ' $a * @return array */ function foo($a) { return $a; } $a1 = ["hi" => 3]; $a2 = ["bye" => 5]; $a3 = array_merge($a1, $a2); foo($a3);', 'assertions' => [ '$a3' => 'array{hi: int, bye: int}', ], ], 'arrayReplaceTKeyedArray' => [ ' $a * @return array */ function foo($a) { return $a; } $a1 = ["hi" => 3]; $a2 = ["bye" => 5]; $a3 = array_replace($a1, $a2); foo($a3);', 'assertions' => [ '$a3' => 'array{hi: int, bye: int}', ], ], 'arrayRand' => [ ' "a", "y" => "b"]; $c = array_rand($vars); $d = $vars[$c]; $more_vars = ["a", "b"]; $e = array_rand($more_vars);', 'assertions' => [ '$vars' => 'array{x: string, y: string}', '$c' => 'string', '$d' => 'string', '$more_vars' => 'array{string, string}', '$e' => 'int', ], ], 'arrayRandMultiple' => [ ' "a", "y" => "b"]; $b = 3; $c = array_rand($vars, 1); $d = array_rand($vars, 2); $e = array_rand($vars, 3); $f = array_rand($vars, $b);', 'assertions' => [ '$vars' => 'array{x: string, y: string}', '$c' => 'string', '$e' => 'list', '$f' => 'list|string', ], ], 'arrayKeysNoEmpty' => [ ' [], 'error_levels' => ['MixedAssignment', 'MixedArgument', 'MixedArgumentTypeCoercion'], ], 'arrayPopNotNullable' => [ ' $list */ function test(array $list) : void { while (!empty($list)) { $tmp = array_pop($list); expectsInt($tmp["item"]); } }', ], 'arrayFilterWithAssert' => [ ' [ '$a' => 'array', ], 'error_levels' => [ 'MissingClosureParamType', ], ], 'arrayFilterUseKey' => [ ' function (): string { return "baz"; }, ]; $foo = array_filter( $foo, function (string $key): bool { return $key === "bar"; }, ARRAY_FILTER_USE_KEY );', 'assertions' => [ '$foo' => 'array', ], ], 'ignoreFalsableCurrent' => [ ' [ ' [ '$foo' => 'int', ], ], 'arraySumOnlyInt' => [ ' [ '$foo' => 'int', ], ], 'arraySumOnlyFloat' => [ ' [ '$foo' => 'float', ], ], 'arraySumNumeric' => [ ' [ '$foo' => 'float|int', ], ], 'arraySumMix' => [ ' [ '$foo' => 'float', ], ], 'arrayMapWithArrayAndCallable' => [ ' */ function foo(array $v): array { $r = array_map("intval", $v); return $r; }', ], 'arrayMapTKeyedArrayAndCallable' => [ ' 1, "key2"=> "2"]; $r = array_map("intval", $v); return $r; }', ], 'arrayMapTKeyedArrayListAndCallable' => [ ' $list */ function takesList(array $list): void {} takesList( array_map( "intval", ["1", "2", "3"] ) );', ], 'arrayMapTKeyedArrayAndClosure' => [ ' 1, "key2"=> "2"]; $r = array_map(function($i) : int { return intval($i);}, $v); return $r; }', 'assertions' => [], 'error_levels' => [ 'MissingClosureParamType' ], ], 'arrayMapTKeyedArrayListAndClosure' => [ ' $list */ function takesList(array $list): void {} takesList( array_map( function (string $str): string { return $str . "x"; }, ["foo", "bar", "baz"] ) );', ], 'arrayMapUntypedCallable' => [ ' $array */ $a = array_map($callable, $array); /** * @var callable $callable * @var array $array */ $b = array_map($callable, $array, $array); /** * @var callable $callable * @var list $list */ $c = array_map($callable, $list); /** * @var callable $callable * @var list $list */ $d = array_map($callable, $list, $list);', 'assertions' => [ '$a' => 'array', '$b' => 'list', '$c' => 'list', '$d' => 'list', ], ], 'arrayFilterGoodArgs' => [ ' [ ' [], 'error_levels' => ['UndefinedClass'], ], 'arrayFilterIgnoreMissingMethod' => [ ' [], 'error_levels' => ['UndefinedMethod'], ], 'arrayMapParamDefault' => [ ' [ ' [ ' [ ' 'non-empty-literal-string', '$b===' => 'non-empty-literal-string', ] ], 'implodeArrayOfNonEmptyStringAndEmptyString' => [ ' 'non-empty-literal-string', '$b===' => 'non-empty-string', ] ], 'implodeEmptyArrayAndString' => [ ' 'string', '$b===' => 'string', ] ], 'key' => [ ' 1, "two" => 3]; $b = key($a);', 'assertions' => [ '$b' => 'null|string', ], ], 'keyEmptyArray' => [ ' [ '$b' => 'null', ], ], 'keyNonEmptyArray' => [ ' [ ' */ function makeArray(): array { return ["one" => 1, "two" => 3]; } $a = makeArray(); $b = array_key_first($a); $c = null; if ($b !== null) { $c = $a[$b]; }', 'assertions' => [ '$b' => 'null|string', '$c' => 'int|null', ], ], 'arrayKeyFirstNonEmpty' => [ ' 1, "two" => 3]; $b = array_key_first($a); $c = $a[$b];', 'assertions' => [ '$b' => 'string', '$c' => 'int', ], ], 'arrayKeyFirstEmpty' => [ ' [ '$b' => 'null' ], ], 'arrayKeyLast' => [ ' */ function makeArray(): array { return ["one" => 1, "two" => 3]; } $a = makeArray(); $b = array_key_last($a); $c = null; if ($b !== null) { $c = $a[$b]; }', 'assertions' => [ '$b' => 'null|string', '$c' => 'int|null', ], ], 'arrayKeyLastNonEmpty' => [ ' 1, "two" => 3]; $b = array_key_last($a); $c = $a[$b];', 'assertions' => [ '$b' => 'string', '$c' => 'int', ], ], 'arrayKeyLastEmpty' => [ ' [ '$b' => 'null' ], ], 'arrayResetNonEmptyArray' => [ ' */ function makeArray(): array { return ["one" => 1, "two" => 3]; } $a = makeArray(); $b = reset($a);', 'assertions' => [ '$b' => 'int' ], ], 'arrayResetNonEmptyList' => [ ' */ function makeArray(): array { return [1, 3]; } $a = makeArray(); $b = reset($a);', 'assertions' => [ '$b' => 'int' ], ], 'arrayResetNonEmptyTKeyedArray' => [ ' 1, "two" => 3]; $b = reset($a);', 'assertions' => [ '$b' => 'int' ], ], 'arrayResetEmptyArray' => [ ' [ '$b' => 'false' ], ], 'arrayResetEmptyList' => [ ' */ function makeArray(): array { return []; } $a = makeArray(); $b = reset($a);', 'assertions' => [ '$b' => 'false' ], ], 'arrayResetMaybeEmptyArray' => [ ' */ function makeArray(): array { return ["one" => 1, "two" => 3]; } $a = makeArray(); $b = reset($a);', 'assertions' => [ '$b' => 'false|int' ], ], 'arrayResetMaybeEmptyList' => [ ' */ function makeArray(): array { return []; } $a = makeArray(); $b = reset($a);', 'assertions' => [ '$b' => 'false|int' ], ], 'arrayResetMaybeEmptyTKeyedArray' => [ ' [ '$b' => 'false|int' ], ], 'arrayEndNonEmptyArray' => [ ' */ function makeArray(): array { return ["one" => 1, "two" => 3]; } $a = makeArray(); $b = end($a);', 'assertions' => [ '$b' => 'int' ], ], 'arrayEndNonEmptyList' => [ ' */ function makeArray(): array { return [1, 3]; } $a = makeArray(); $b = end($a);', 'assertions' => [ '$b' => 'int' ], ], 'arrayEndNonEmptyTKeyedArray' => [ ' 1, "two" => 3]; $b = end($a);', 'assertions' => [ '$b' => 'int' ], ], 'arrayEndEmptyArray' => [ ' [ '$b' => 'false' ], ], 'arrayEndEmptyList' => [ ' */ function makeArray(): array { return []; } $a = makeArray(); $b = end($a);', 'assertions' => [ '$b' => 'false' ], ], 'arrayEndMaybeEmptyArray' => [ ' */ function makeArray(): array { return ["one" => 1, "two" => 3]; } $a = makeArray(); $b = end($a);', 'assertions' => [ '$b' => 'false|int' ], ], 'arrayEndMaybeEmptyList' => [ ' */ function makeArray(): array { return []; } $a = makeArray(); $b = end($a);', 'assertions' => [ '$b' => 'false|int' ], ], 'arrayEndMaybeEmptyTKeyedArray' => [ ' [ '$b' => 'false|int' ], ], 'arrayColumnInference' => [ '> */ function makeGenericArray(): array { return []; } /** @return array */ function makeShapeArray(): array { return []; } /** @return array */ function makeUnionArray(): array { return []; } /** @return array */ function makeKeyedArray(): array { return []; } $a = array_column([[1], [2], [3]], 0); $b = array_column([["a" => 1], ["a" => 2], ["a" => 3]], "a"); $c = array_column([["a" => 1], ["a" => 2], ["a" => 3]], null, "a"); $d = array_column([["a" => 1], ["a" => 2], ["a" => 3]], null, "b"); $e = array_column([["a" => 1], ["a" => 2], ["a" => 3]], rand(0,1) ? "a" : "b", "b"); $f = array_column([["k" => "a", "v" => 1], ["k" => "b", "v" => 2]], "v", "k"); $g = array_column([], 0); $h = array_column(makeMixedArray(), 0); $i = array_column(makeMixedArray(), 0, "k"); $j = array_column(makeMixedArray(), 0, null); $k = array_column(makeGenericArray(), 0); $l = array_column(makeShapeArray(), 0); $m = array_column(makeUnionArray(), 0); $n = array_column([[0 => "test"]], 0); $o = array_column(makeKeyedArray(), "y"); $p_prepare = makeKeyedArray(); assert($p_prepare !== []); $p = array_column($p_prepare, "y"); ', 'assertions' => [ '$a' => 'non-empty-list', '$b' => 'non-empty-list', '$c' => 'array', '$d' => 'array', '$e' => 'array', '$f' => 'non-empty-array', '$g' => 'list', '$h' => 'list', '$i' => 'array', '$j' => 'list', '$k' => 'list', '$l' => 'list', '$m' => 'list', '$n' => 'non-empty-list', '$o' => 'list', '$p' => 'list', ], ], 'splatArrayIntersect' => [ ' [ '$bar' => 'array', ], ], 'arrayIntersectIsVariadic' => [ ' [], ], 'arrayIntersectKeyIsVariadic' => [ ' [], ], 'arrayIntersectKeyNoReturnType' => [ ' "hello"]; } class C { /** * @psalm-suppress MissingReturnType */ public static function unknownStatic() { return ["x" => "hello"]; } /** * @psalm-suppress MissingReturnType */ public static function unknownInstance() { return ["x" => "hello"]; } } /** * @psalm-suppress MixedArgument */ function sdn(array $s) : void { $r = array_intersect_key(unknown(), array_filter($s)); if (empty($r)) {} $r = array_intersect_key(C::unknownStatic(), array_filter($s)); if (empty($r)) {} $r = array_intersect_key((new C)->unknownInstance(), array_filter($s)); if (empty($r)) {} }', ], 'arrayIntersectAssoc' => [ ' $a * @var array $b * @var array $c */ $r = array_intersect_assoc($a, $b, $c);', 'assertions' => [ '$r' => 'array', ], ], 'arrayReduce' => [ ' [ '$direct_closure_result' => 'int', '$passed_closure_result' => 'int', '$function_call_result' => 'int', ], ], 'arrayReduceStaticMethods' => [ ' [], ], 'arrayReduceMixedReturn' => [ ' [], 'error_levels' => ['MissingClosureReturnType', 'MixedAssignment'], ], 'arraySpliceArray' => [ ' [ '$a' => 'non-empty-list', '$b' => 'array{string, string, string}', '$c' => 'array{int, int, int}', ], ], 'arraySpliceReturn' => [ ' [ '$e' => 'list' ], ], 'arraySpliceOtherType' => [ ' [ '$d' => 'array', ], ], 'ksortPreserveShape' => [ ' 3, "b" => 4]; ksort($a); acceptsAShape($a); /** * @param array{a:int,b:int} $a */ function acceptsAShape(array $a): void {}', ], 'arraySlicePreserveKeys' => [ ' 1, "b" => 2, "c" => 3]; $b = array_slice($a, 1, 2, true); $c = array_slice($a, 1, 2, false); $d = array_slice($a, 1, 2);', 'assertions' => [ '$b' => 'array', '$c' => 'array', '$d' => 'array', ], ], 'arraySliceDontPreserveIntKeys' => [ ' "a", 4 => "b", 3 => "c"]; $b = array_slice($a, 1, 2, true); $c = array_slice($a, 1, 2, false); $d = array_slice($a, 1, 2);', 'assertions' => [ '$b' => 'array', '$c' => 'list', '$d' => 'list', ], ], 'arrayReversePreserveNonEmptiness' => [ ' [ ' */ function Foo(DateTime ...$dateTimes) : array { return array_map( function ($dateTime) { return ($dateTime->format("c")); }, $dateTimes ); }', ], 'inferArrayMapArrowFunctionReturnType' => [ ' */ function Foo(DateTime ...$dateTimes) : array { return array_map( fn ($dateTime) => ($dateTime->format("c")), $dateTimes ); }', 'assertions' => [], 'error_levels' => [], 'php_version' => '7.4', ], 'arrayPad' => [ ' 1, "bar" => 2], 10, 123); $b = array_pad(["a", "b", "c"], 10, "x"); /** @var list $list */ $c = array_pad($list, 10, 0); /** @var array $array */ $d = array_pad($array, 10, "");', 'assertions' => [ '$a' => 'non-empty-array', '$b' => 'non-empty-list', '$c' => 'non-empty-list', '$d' => 'non-empty-array', ], ], 'arrayPadDynamicSize' => [ ' 1, "bar" => 2], getSize(), 123); $b = array_pad(["a", "b", "c"], getSize(), "x"); /** @var list $list */ $c = array_pad($list, getSize(), 0); /** @var array $array */ $d = array_pad($array, getSize(), "");', 'assertions' => [ '$a' => 'array', '$b' => 'list', '$c' => 'list', '$d' => 'array', ], ], 'arrayPadZeroSize' => [ ' [ '$result' => 'array', ], ], 'arrayPadTypeCombination' => [ ' 1, "bar" => "two"], 5, false); $b = array_pad(["a", 2, 3.14], 5, null); /** @var list $list */ $c = array_pad($list, 5, 0); /** @var array $array */ $d = array_pad($array, 5, null);', 'assertions' => [ '$a' => 'non-empty-array', '$b' => 'non-empty-list', '$c' => 'non-empty-list', '$d' => 'non-empty-array', ], ], 'arrayPadMixed' => [ ' [ '$a' => 'non-empty-array', '$b' => 'non-empty-list', '$c' => 'non-empty-list', '$d' => 'non-empty-array', ], ], 'arrayPadFallback' => [ ' [ '$result' => 'array', ], ], 'arrayChunk' => [ ' $list */ $b = array_chunk($list, 2); /** @var array $arr */ $c = array_chunk($arr, 2); ', 'assertions' => [ '$a' => 'list>', '$b' => 'list>', '$c' => 'list>', ], ], 'arrayChunkPreservedKeys' => [ ' $list */ $b = array_chunk($list, 2, true); /** @var array $arr */ $c = array_chunk($arr, 2, true);', 'assertions' => [ '$a' => 'list>', '$b' => 'list>', '$c' => 'list>', ], ], 'arrayChunkPreservedKeysExplicitFalse' => [ ' $arr */ $result = array_chunk($arr, 2, false);', 'assertions' => [ '$result' => 'list>', ], ], 'arrayChunkMixed' => [ ' $list */ $b = array_chunk($list, 2); /** @var mixed[] $arr */ $c = array_chunk($arr, 2);', 'assertions' => [ '$a' => 'list>', '$b' => 'list>', '$c' => 'list>', ], ], 'arrayChunkFallback' => [ ' [ '$result' => 'list>', ], ], 'arrayMapPreserveNonEmptiness' => [ ' $strings * @psalm-return non-empty-list */ function foo(array $strings): array { return array_map("intval", $strings); }' ], 'SKIPPED-arrayMapZip' => [ ' */ function getCharPairs(string $line) : array { $chars = str_split($line); return array_map( null, $chars, array_slice($chars, 1) ); }' ], 'arrayFillKeys' => [ ' [ '$result' => 'array', ], ], 'shuffle' => [ ' 123, "bar" => 456]; shuffle($array); $emptyArray = []; shuffle($emptyArray);', 'assertions' => [ '$array' => 'non-empty-list', '$emptyArray' => 'list', ], ], 'sort' => [ ' 123, "bar" => 456]; sort($array); $emptyArray = []; sort($emptyArray);', 'assertions' => [ '$array' => 'non-empty-list', '$emptyArray' => 'list', ], ], 'rsort' => [ ' 123, "bar" => 456]; rsort($array); $emptyArray = []; rsort($emptyArray);', 'assertions' => [ '$array' => 'non-empty-list', '$emptyArray' => 'list', ], ], 'usort' => [ ' $b; } $array = ["foo" => 123, "bar" => 456]; usort($array, "baz"); $emptyArray = []; usort($emptyArray, "baz");', 'assertions' => [ '$array' => 'non-empty-list', '$emptyArray' => 'list', ], ], 'closureParamConstraintsMet' => [ ' [ ' */ function makeAList(int $ofThisInteger): array { return array_filter([$ofThisInteger]); }' ], 'arrayMapWithEmptyArrayReturn' => [ '> $elements * @return list */ function resolvePossibleFilePaths($elements) : array { return array_values( array_filter( array_merge( ...array_map( function (array $element) : array { if (rand(0,1) == 1) { return []; } return $element; }, $elements ) ) ) ); }' ], 'arrayFilterArrowFunction' => [ ' $x instanceof B );', 'assertions' => [ '$a' => 'array', '$b' => 'array', ], 'error_levels' => [], '7.4', ], 'arrayMergeTwoExplicitLists' => [ ' $foo */ function foo(array $foo) : void {} $foo1 = [1, 2, 3]; $foo2 = [1, 4, 5]; foo(array_merge($foo1, $foo2));' ], 'arrayMergeTwoPossiblyFalse' => [ ' 'list' ], ], 'arrayReplaceTwoExplicitLists' => [ ' $foo */ function foo(array $foo) : void {} $foo1 = [1, 2, 3]; $foo2 = [1, 4, 5]; foo(array_replace($foo1, $foo2));' ], 'arrayReplaceTwoPossiblyFalse' => [ ' 'list' ], ], 'arrayMapPossiblyFalseIgnored' => [ 'format("Y-m-d")]; takesString($a[0]); array_map("takesString", $a);', ], 'arrayMapExplicitZip' => [ ' [$a => $b], $as, $bs);', 'assertions' => [], 'error_levels' => [], '7.4', ], 'spliceTurnsintKeyedInputToList' => [ ' $elements * @return list */ function bar(array $elements, int $index, string $element) : array { array_splice($elements, $index, 0, [$element]); return $elements; }' ], 'arrayChangeKeyCaseWithNonStringKeys' => [ ' 42]; echo array_change_key_case($a, CASE_LOWER)[0];' ], 'mapInterfaceMethod' => [ ' $strings * @return list */ function mapList(MapperInterface $m, array $strings): array { return array_map([$m, "map"], $strings); }' ], 'arrayShiftComplexArray' => [ ' $slugParts */ function foo(array $slugParts) : void { if (!$slugParts) { $slugParts = [""]; } array_shift($slugParts); if (!empty($slugParts)) {} }' ], 'arrayMergeKeepLastKeysAndType' => [ ' $b * * @return array{A: int} */ function merger(array $a, array $b) : array { return array_merge($b, $a); }' ], 'arrayMergeKeepFirstKeysSameType' => [ ' $b * * @return array{A: int} */ function merger(array $a, array $b) : array { return array_merge($a, $b); }' ], 'arrayReplaceKeepLastKeysAndType' => [ ' $b * * @return array{A: int} */ function merger(array $a, array $b) : array { return array_replace($b, $a); }' ], 'arrayReplaceKeepFirstKeysSameType' => [ ' $b * * @return array{A: int} */ function merger(array $a, array $b) : array { return array_replace($a, $b); }' ], 'filteredArrayCanBeEmpty' => [ ' [ ' $lengths */ function doStuff($lengths): void { /** @psalm-suppress MixedArgument, MixedAssignment */ $length = array_shift($lengths); if ($length !== null) {} }' ], 'countOnListIntoTuple' => [ ' $list */ function bar(array $list) : void { if (count($list) === 2) { foo($list); } }' ], 'arrayColumnwithKeyedArrayWithoutRedundantUnion' => [ ' $foos */ function foo(array $foos): void { array_multisort($formLayoutFields, SORT_ASC, array_column($foos, "y")); }' ], 'arrayMapGenericObject' => [ ' $container * @param array $data * @return array */ function bar(Container $container, array $data): array { return array_map( [$container, "get"], $data ); }' ], 'arrayMapShapeAndGenericArray' => [ ' to array{0:string} throw new InvalidArgumentException; } $line = array_map( // should not destroy part function($val) { return (int)$val; }, $line ); ', 'assertions' => [ '$line===' => 'array{0: int}', ], ], 'arrayUnshiftOnEmptyArrayMeansNonEmptyList' => [ ' */ function foo(): array { $a = []; array_unshift($a, "string"); return $a; }', ], 'keepClassStringInOffsetThroughArrayMerge' => [ ' */ private array $a; public function __construct() { $this->a = []; } public function handle(): void { $b = [A::class => "d"]; $this->a = array_merge($this->a, $b); } } ', ], ]; } /** * @return iterable */ public function providerInvalidCodeParse(): iterable { return [ 'arrayFilterWithoutTypes' => [ ' 5, "b" => 12, "c" => null], function(?int $i) { return $_GET["a"]; } );', 'error_message' => 'MixedArgumentTypeCoercion', 'error_levels' => ['MissingClosureParamType', 'MissingClosureReturnType'], ], 'arrayFilterUseMethodOnInferrableInt' => [ 'foo(); });', 'error_message' => 'InvalidMethodCall', ], 'arrayMapUseMethodOnInferrableInt' => [ 'foo(); }, [1, 2, 3, 4]);', 'error_message' => 'InvalidMethodCall', ], 'arrayMapWithNonCallableStringArray' => [ ' 'InvalidArgument', ], 'arrayMapWithNonCallableIntArray' => [ ' 'InvalidArgument', ], 'arrayFilterBadArgs' => [ ' 'InvalidScalarArgument', ], 'arrayFillPositiveConstantLength' => [ ' 'TypeDoesNotContainType' ], 'arrayFilterTooFewArgs' => [ ' 'TooFewArguments', ], 'arrayMapBadArgs' => [ ' 'InvalidScalarArgument', ], 'arrayMapTooFewArgs' => [ ' 'TooFewArguments', ], 'arrayMapTooManyArgs' => [ ' 'TooManyArguments', ], 'arrayReduceInvalidClosureTooFewArgs' => [ ' 'InvalidArgument', 'error_levels' => ['MixedTypeCoercion'], ], 'arrayReduceInvalidItemType' => [ ' 'InvalidArgument', 'error_levels' => ['MissingClosureReturnType'], ], 'arrayReduceInvalidCarryType' => [ ' 'InvalidArgument', 'error_levels' => ['MissingClosureReturnType'], ], 'arrayReduceInvalidCarryOutputType' => [ ' 'InvalidArgument', ], 'arrayPopNotNull' => [ ' $list */ function test(array $list) : void { while (!empty($list)) { $tmp = array_pop($list); if ($tmp === null) {} } }', 'error_message' => 'DocblockTypeContradiction', ], 'usortInvalidCallableString' => [ ' 'InvalidArgument', ], 'arrayShiftUndefinedVariable' => [ ' 'UndefinedVariable', ], 'arrayFilterTKeyedArray' => [ ' $ints */ function ints(array $ints) : void {} $brr = array_filter([2,3,0,4,5]); ints($brr);', 'error_message' => 'InvalidArgument', ], 'usortOneParamInvalid' => [ ' (int) ($a > $b));', 'error_message' => 'InvalidScalarArgument', [], false, '7.4', ], 'usortInvalidComparison' => [ ' 'InvalidArgument', ], 'arrayMergeKeepFirstKeysButNotType' => [ ' $b * * @return array{A: int} */ function merger(array $a, array $b) : array { return array_merge($a, $b); }', 'error_message' => 'LessSpecificReturnStatement - src' . DIRECTORY_SEPARATOR . 'somefile.php:9:32 - The type \'array{A: int|string}\' is more general', ], 'arrayReplaceKeepFirstKeysButNotType' => [ ' $b * * @return array{A: int} */ function merger(array $a, array $b) : array { return array_replace($a, $b); }', 'error_message' => 'LessSpecificReturnStatement - src' . DIRECTORY_SEPARATOR . 'somefile.php:9:32 - The type \'array{A: int|string}\' is more general', ], 'arrayWalkOverObject' => [ ' 'RawObjectIteration', ], 'arrayWalkRecursiveOverObject' => [ ' 'RawObjectIteration', ], ]; } }