Pipe operator

Zend/tests/pipe_operator/ast.phpt

@@ -0,0 +1,25 @@
+--TEST--
+Test that a pipe operator displays as a pipe operator when outputting syntax.
+--FILE--
+<?php
+
+function _test(int $a): int {
+    return $a + 1;
+}
+
+try {
+    assert((5 |> '_test') == 99);
+} catch (AssertionError $e) {
+    echo $e->getMessage(), PHP_EOL;
+}
+
+try {
+    assert((5 |> _test(...)) == 99);
+} catch (AssertionError $e) {
+    echo $e->getMessage(), PHP_EOL;
+}
+
+?>
+--EXPECTF--
+assert(5 |> '_test' == 99)
+assert(5 |> _test(...) == 99)

Zend/tests/pipe_operator/call_by_ref.phpt

@@ -0,0 +1,37 @@
+--TEST--
+Pipe operator rejects by-reference functions.
+--FILE--
+<?php
+
+function _modify(int &$a): string {
+    $a += 1;
+    return "foo";
+}
+
+function _append(array &$a): string {
+    $a['bar'] = 'beep';
+}
+
+// Simple variables
+try {
+    $a = 5;
+    $res1 = $a |> _modify(...);
+    var_dump($res1);
+} catch (\Error $e) {
+  echo $e->getMessage(), PHP_EOL;
+}
+
+// Complex variables.
+try {
+    $a = ['foo' => 'beep'];
+    $res2 = $a |> _append(...);
+    var_dump($res2);
+} catch (\Error $e) {
+  echo $e->getMessage(), PHP_EOL;
+}
+
+
+?>
+--EXPECTF--
+_modify(): Argument #1 ($a) could not be passed by reference
+_append(): Argument #1 ($a) could not be passed by reference

Zend/tests/pipe_operator/call_prefer_by_ref.phpt

@@ -0,0 +1,17 @@
+--TEST--
+Pipe operator accepts prefer-by-reference functions.
+--FILE--
+<?php
+
+$a = ['hello', 'world'];
+
+try {
+    $r = $a |> array_multisort(...);
+    var_dump($r);
+} catch (\Error $e) {
+  echo $e->getMessage(), PHP_EOL;
+}
+
+?>
+--EXPECT--
+bool(true)

Zend/tests/pipe_operator/compound_userland_calls.phpt

@@ -0,0 +1,19 @@
+--TEST--
+Pipe operator chains
+--FILE--
+<?php
+
+function _test1(int $a): int {
+    return $a + 1;
+}
+
+function _test2(int $a): int {
+    return $a * 2;
+}
+
+$res1 = 5 |> '_test1' |> '_test2';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(12)

Zend/tests/pipe_operator/function_not_found.phpt

@@ -0,0 +1,15 @@
+--TEST--
+Pipe operator throws normally on missing function
+--FILE--
+<?php
+
+try {
+    $res1 = 5 |> '_test';
+}
+catch (Throwable $e) {
+    echo $e::class, ": ", $e->getMessage(), PHP_EOL;
+}
+
+?>
+--EXPECT--
+Error: Call to undefined function _test()

Zend/tests/pipe_operator/mixed_callable_call.phpt

@@ -0,0 +1,49 @@
+--TEST--
+Pipe operator handles all callable styles
+--FILE--
+<?php
+
+function _add(int $x, int $y): int {
+    return $x + $y;
+}
+
+function _area(int $x, int $y): int {
+    return $x * $y;
+}
+
+class _Test
+{
+    public function message(string $which): string
+    {
+        if ($which == 1) {
+            return "Hello";
+        }
+        else if ($which == 2) {
+            return "Goodbye";
+        }
+        else {
+            return "World";
+        }
+    }
+}
+
+function _double(int $x): int {
+    return $x * 2;
+}
+
+$test = new _Test();
+
+$add3 = fn($x) => _add($x, 3);
+
+$res1 = 2
+    |> [$test, 'message']
+    |> 'strlen'
+    |> $add3
+    |> fn($x) => _area($x, 2)
+    |> _double(...)
+;
+
+var_dump($res1);
+?>
+--EXPECT--
+int(40)

Zend/tests/pipe_operator/optional_parameters.phpt

@@ -0,0 +1,15 @@
+--TEST--
+Pipe operator accepts optional-parameter functions
+--FILE--
+<?php
+
+function _test(int $a, int $b = 3) {
+    return $a + $b;
+}
+
+$res1 = 5 |> '_test';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(8)

Zend/tests/pipe_operator/precedence_addition.phpt

@@ -0,0 +1,17 @@
+--TEST--
+Pipe binds lower than addition
+--FILE--
+<?php
+
+function _test1(int $a): int {
+    return $a * 2;
+}
+
+$bad_func = null;
+
+$res1 = 5 + 2 |>  '_test1';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(14)

Zend/tests/pipe_operator/precedence_coalesce.phpt

@@ -0,0 +1,17 @@
+--TEST--
+Pipe binds lower than coalesce
+--FILE--
+<?php
+
+function _test1(int $a): int {
+    return $a * 2;
+}
+
+$bad_func = null;
+
+$res1 = 5 |> $bad_func ?? '_test1';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(10)

Zend/tests/pipe_operator/precedence_comparison.phpt

@@ -0,0 +1,17 @@
+--TEST--
+Pipe binds higher than comparison
+--FILE--
+<?php
+
+function _test1(int $a): int {
+    return $a * 2;
+}
+
+// This will error without the parens,
+// as it will try to compare a closure to an int first.
+$res1 = (5 |> _test1(...)) == 10 ;
+var_dump($res1);
+
+?>
+--EXPECT--
+bool(true)

Zend/tests/pipe_operator/precedence_ternary.phpt

@@ -0,0 +1,42 @@
+--TEST--
+Pipe binds lower than ternary
+--FILE--
+<?php
+
+function _test1(int $a): int {
+    return $a + 1;
+}
+
+function _test2(int $a): int {
+    return $a * 2;
+}
+
+function _test3(int $a): int {
+    return $a * 100;
+}
+
+// $config is null, so the second function gets used.
+$config = null;
+$res1 = 5 |> $config ? _test1(...) : _test2(...);
+var_dump($res1);
+
+// $config is truthy, so the ternary binds first
+// and evaluates to the first function.
+$config = _test3(...);
+$res2 = 5 |> $config ? _test1(...) : _test2(...);
+var_dump($res2);
+
+// Binding the ternary first doesn't make logical sense,
+// so the pipe runs first in this case.
+$x = true;
+$y = 'beep';
+$z = 'default';
+$ret3 = $x ? $y |> strlen(...) : $z;
+var_dump($ret3);
+
+
+?>
+--EXPECT--
+int(10)
+int(6)
+int(4)

Zend/tests/pipe_operator/simple_builtin_call.phpt

@@ -0,0 +1,11 @@
+--TEST--
+Pipe operator supports built-in functions
+--FILE--
+<?php
+
+$res1 = "Hello" |> 'strlen';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(5)

Zend/tests/pipe_operator/simple_userland_call.phpt

@@ -0,0 +1,15 @@
+--TEST--
+Pipe operator supports user-defined functions
+--FILE--
+<?php
+
+function _test(int $a): int {
+    return $a + 1;
+}
+
+$res1 = 5 |> '_test';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(6)

Zend/tests/pipe_operator/too_many_parameters.phpt

@@ -0,0 +1,21 @@
+--TEST--
+Pipe operator fails on multi-parameter functions
+--FILE--
+<?php
+
+function _test(int $a, int $b) {
+    return $a + $b;
+}
+
+
+try {
+    $res1 = 5 |> '_test';
+}
+catch (Throwable $e) {
+    echo $e::class, ": ", $e->getMessage(), PHP_EOL;
+}
+
+
+?>
+--EXPECTF--
+ArgumentCountError: Too few arguments to function %s, 1 passed in %s on line %s and exactly 2 expected

Zend/tests/pipe_operator/type_mismatch.phpt

@@ -0,0 +1,20 @@
+--TEST--
+Pipe operator respects types
+--FILE--
+<?php
+
+function _test(int $a, int $b) {
+    return $a + $b;
+}
+
+try {
+    $res1 = "Hello" |> '_test';
+    var_dump($res1);
+}
+catch (Throwable $e) {
+    echo $e::class, ": ", $e->getMessage(), PHP_EOL;
+}
+
+?>
+--EXPECTF--
+TypeError: _test(): Argument #1 ($a) must be of type int, string given, called in %s on line %d

Zend/tests/pipe_operator/void_return.phpt

@@ -0,0 +1,21 @@
+--TEST--
+Pipe operator fails void return chaining in strict mode
+--FILE--
+<?php
+declare(strict_types=1);
+
+function nonReturnFunction($bar): void {}
+
+try {
+    $result = "Hello World"
+        |> 'nonReturnFunction'
+        |> 'strlen';
+    var_dump($result);
+}
+catch (Throwable $e) {
+    echo $e::class, ": ", $e->getMessage(), PHP_EOL;
+}
+
+?>
+--EXPECT--
+TypeError: strlen(): Argument #1 ($string) must be of type string, null given

Zend/tests/pipe_operator/wrapped_chains.phpt

@@ -0,0 +1,21 @@
+--TEST--
+Pipe operator chains saved as a closure
+--FILE--
+<?php
+
+function _test1(int $a): int {
+    return $a + 1;
+}
+
+function _test2(int $a): int {
+    return $a * 2;
+}
+
+$func = fn($x) => $x |> '_test1' |> '_test2';
+
+$res1 = $func(5);
+
+var_dump($res1);
+?>
+--EXPECT--
+int(12)