Implement pipe operator.

Author: Crell

Zend/tests/pipe_operator/ast.phpt

@@ -0,0 +1,18 @@
+--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) {
+    print $e->getMessage();
+}
+
+?>
+--EXPECTF--
+assert(5 |> \_test == 99)

Zend/tests/pipe_operator/call_by_ref.phpt

@@ -0,0 +1,20 @@
+--TEST--
+Pipe operator accepts by-reference functions
+--FILE--
+<?php
+
+function _modify(int &$a): string {
+    $a += 1;
+    return "foo";
+}
+
+//try {
+$a = 5;
+$res1 = $a |> '_modify';
+
+var_dump($res1);
+var_dump($a);
+?>
+--EXPECT--
+string(3) "foo"
+int(6)

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) {
+    printf("Expected %s thrown, got %s", Error::class, get_class($e));
+}
+
+?>
+--EXPECT--
+Expected Error thrown, got Error

Zend/tests/pipe_operator/mixed_callable_call.phpt

@@ -0,0 +1,44 @@
+--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";
+        }
+    }
+}
+
+$test = new _Test();
+
+$add3 = fn($x) => _add($x, 3);
+
+$res1 = 2
+    |> [$test, 'message']
+    |> 'strlen'
+    |> $add3
+    |> fn($x) => _area($x, 2)
+;
+
+var_dump($res1);
+?>
+--EXPECT--
+int(20)

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 + 1;
+}
+
+$bad_func = null;
+
+$res1 = 5 + 2 |>  '_test1';
+
+var_dump($res1);
+?>
+--EXPECT--
+int(8)

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_ternary.phpt

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

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)