Make compatible with PHP's pattern matching RFC

[thekid]

This PR extends the basic type matching capabilities and implements all of https://wiki.php.net/rfc/pattern-matching

Implementation status

• Literal patterns
• Class constant patterns
• Numeric comparison patterns
• Object patterns
• Array sequence patterns
• Associative array patterns
• Compound patterns with & and |
• Match expression syntax change - match (...) is, see https://wiki.php.net/rfc/pattern-matching#match_is_placement

Notes

• The PHP PR currently uses a different match syntax as the one described in the RFC, see here
• The PHP PR currently includes the range syntax listed under Future scope in the RFC

See also

• [RFC] Pattern matching php/php-src#20574
• https://externals.io/message/129490
• https://wiki.php.net/rfc/adts
• https://github.com/Crell/php-rfcs/blob/master/pattern-matching/future.md

[thekid]

In Python, the following works:

match command.split():
    case ["drop", *objects]:
        for obj in objects:
            character.drop(obj, current_room)
    # The rest of your commands go here

Maybe we should be able to bind to variables when using the spread operator, too?

---

Example:

if ([1, 2, 3] is [1, ...$rest]) {
  var_dump($rest); // [2, 3]
}

POC:

diff --git a/src/main/php/lang/ast/syntax/php/IsOperator.class.php b/src/main/php/lang/ast/syntax/php/IsOperator.class.php
index af55634..1d3b4f8 100755
--- a/src/main/php/lang/ast/syntax/php/IsOperator.class.php
+++ b/src/main/php/lang/ast/syntax/php/IsOperator.class.php
@@ -74,8 +74,16 @@ class IsOperator implements Extension {
         $parse->forward();
         if (']' !== $parse->token->value) do {
           if ('...' === $parse->token->value) {
-            $r->rest= true;
             $parse->forward();
+
+            // Bind rest of array via `... $rest`
+            if ('variable' === $parse->token->kind) {
+              $parse->forward();
+              $r->rest= new Variable($parse->token->value);
+              $parse->forward();
+            } else {
+              $r->rest= true;
+            }
             break;
           }
 
@@ -233,6 +241,21 @@ class IsOperator implements Extension {
             $match($codegen, new OffsetExpression($temp, $offset), $p),
           ));
         }
+
+        if ($pattern->rest instanceof Variable) {
+          $true= new Literal('true');
+          return new BinaryExpression($compound, '&&', new Braced(
+            new TernaryExpression(
+              new Braced(new Assignment($pattern->rest, '=', isset($key)
+                ? new InvokeExpression(new Literal('array_slice'), [$temp, new Literal((string)($key + 1))])
+                : $temp
+              )),
+              $true,
+              $true
+            ))
+          );
+        }
+
         return $compound;
       } else if ($pattern instanceof IsObjectStructure) {
         $temp= new Variable($codegen->symbol());
diff --git a/src/test/php/lang/ast/syntax/php/unittest/VariableBindingTest.class.php b/src/test/php/lang/ast/syntax/php/unittest/VariableBindingTest.class.php
index 57645d0..57b82e7 100755
--- a/src/test/php/lang/ast/syntax/php/unittest/VariableBindingTest.class.php
+++ b/src/test/php/lang/ast/syntax/php/unittest/VariableBindingTest.class.php
@@ -29,6 +29,9 @@ class VariableBindingTest extends EmittingTest {
     yield ['[0, 1, 2] is [$x, $y, $z] ? [$x, $y, $z] : null', [0, 1, 2]];
 
     yield ['[1, [1]] is [1, $rest] ? $rest : null', [1]];
+    yield ['[1, [1]] is [1, ...$rest] ? $rest : null', [[1]]];
+    yield ['[1, 2, 3] is [...$rest] ? $rest : null', [1, 2, 3]];
+    yield ['[1, 2, 3] is [1, ...$rest] ? $rest : null', [2, 3]];
 
     yield ['["one" => 1, "two" => 2] is ["one" => 1, "two" => $t] ? $t : null', 2];
     yield ['["one" => 0, "two" => 2] is ["one" => 1, "two" => $t] ? $t : null', null];

[thekid]

Variable bindings can replace destructuring assignments in most cases:

list()	is	Note
[$a, $b]= $list	$list is [$a, $b]
[$a, , $b]= $list	$list is [$a, mixed, $b]
[[$a, $b], $c]= $nested	$nested is [[$a, $b], $c]
['key' => $key]= $map	$map is ['key' => $key]
[$a[]]= $list		*Can only bind variables *
[$a['key']]= $list		*Can only bind variables *
[$this->member]= $list		*Can only bind variables *

The is operator also has the benefit of not raising errors when $list does not contain the number of elements necessary for destructuring, and instead returns false:

if ($list is [$a, $b, ...]) {
  var_dump($a, $b);
}

// Equivalent of, guarded by type and length checks to prevent errors
if (is_array($list) && sizeof($list) >= 2) {
  [$a, $b]= $list;
  var_dump($a, $b);
}