From 3fbdbcc1f78e8514b73ae7a06adb6af7855744bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?= Date: Tue, 17 Nov 2026 12:20:58 +0900 Subject: [PATCH] =?UTF-8?q?=E9=96=A2=E6=95=B0=E3=81=AE=E9=83=A8=E5=88=86?= =?UTF-8?q?=E9=81=A9=E7=94=A8=E3=81=AE=E8=AA=AC=E6=98=8E=E3=82=92=E5=8E=9F?= =?UTF-8?q?=E6=96=87=E3=81=AE=E5=A4=89=E6=9B=B4=E3=81=AB=E8=BF=BD=E5=BE=93?= =?UTF-8?q?=20(6=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- appendices/migration86/new-features.xml | 5 +- appendices/migration86/other-changes.xml | 4 +- language/constants.xml | 9 +- language/functions.xml | 314 ++++++++++++++++++++++- language/operators/functional.xml | 31 ++- language/types/callable.xml | 7 +- 6 files changed, 361 insertions(+), 9 deletions(-) diff --git a/appendices/migration86/new-features.xml b/appendices/migration86/new-features.xml index 1276476ec6..7701e754f1 100644 --- a/appendices/migration86/new-features.xml +++ b/appendices/migration86/new-features.xml @@ -1,6 +1,6 @@ - + 新機能 @@ -144,7 +144,8 @@ class Package implements HasVersion 関数の部分適用 - 関数の部分適用がサポートされました。 + 関数の部分適用 + がサポートされました。 1 つ以上の引数を ? プレースホルダに、または残りの引数を ... プレースホルダに置き換えて呼び出すと、足りない引数を受け取る Closure が作成されます。 diff --git a/appendices/migration86/other-changes.xml b/appendices/migration86/other-changes.xml index 0ad3cf3802..a47b13aa46 100644 --- a/appendices/migration86/other-changes.xml +++ b/appendices/migration86/other-changes.xml @@ -1,6 +1,6 @@ - + その他の変更 @@ -388,7 +388,7 @@ 第一級callable - や 関数の部分適用 + や 関数の部分適用 で作ったコールバックを渡す array_map の呼び出しは、同等の foreach ループにコンパイルされるようになりました。 diff --git a/language/constants.xml b/language/constants.xml index 941dae126b..9e9763501d 100644 --- a/language/constants.xml +++ b/language/constants.xml @@ -1,6 +1,6 @@ - + @@ -241,6 +241,13 @@ echo ANIMALS_DEF[1] . "\n"; // 出力は "cat" + + 8.6.0 + + 定数式に、関数の部分適用 + のサポートが追加されました。 + + 8.5.0 diff --git a/language/functions.xml b/language/functions.xml index 4b29cbbe64..b7b128ff0a 100644 --- a/language/functions.xml +++ b/language/functions.xml @@ -1,6 +1,6 @@ - + 関数 @@ -1748,6 +1748,30 @@ $privateMethod(); // Foo1::privateMethod + + PHP 8.6.0 以降では、引数の一部だけを渡し、残りは ? プレースホルダにして + Closure を生成できます。 + 詳しくは 関数の部分適用 を参照ください。 + + 部分適用の簡単な例 + +method(1, ?); // $second を受け取ります +$partial2 = $obj->method(?, 2); // $first を受け取ります +$partial3 = Foo::staticmethod(1, ...); // 残りの引数をすべて受け取ります +]]> + + + + この記法を使ってオブジェクトを生成する操作 @@ -1798,6 +1822,294 @@ $obj?->prop->method(...); + + 関数の部分適用 + + + 部分適用は、PHP 8.6.0 以降で使えます。 + 関数やメソッドの呼び出しで引数の一部だけを渡し、残りはプレースホルダにすると、 + 関数は呼び出されず、プレースホルダにした引数を受け取る + Closure が生成されます。 + 第一級callableを生成する記法 + は、引数を 1 つも渡さない部分適用にあたります。 + 部分適用はこの記法を拡張したもので、呼び出し可能な式であれば何にでも使えます。 + その式で呼び出される関数やメソッドは、Closure の生成時に決まります。 + + + + + + ? はちょうど 1 つの引数を表します。 + このプレースホルダに対応する Closure の引数は、 + 元の関数の引数が省略可能であっても常に必須です。 + + + + + ... は、残りの引数をすべて表します。 + これらの引数のデフォルト値は保たれ、可変長引数もそのままです。 + このプレースホルダは、引数の最後に 1 回しか書けません。 + + + + + + 部分適用 + + volume(2, $width, 4) と同等です +var_dump($closure(3)); + +$closure = volume(?, 3, ?); +// static fn(int $length, int $height): int => volume($length, 3, $height) と同等です +var_dump($closure(2, 4)); + +// "..." は残りの引数をすべて表します +$closure = volume(2, ...); +// static fn(int $width, int $height): int => volume(2, $width, $height) と同等です +var_dump($closure(3, 4)); + +// 引数をすべて渡した場合、"..." は呼び出しを遅らせるだけです +$closure = volume(2, 3, 4, ...); +// static fn(): int => volume(2, 3, 4) と同等です +var_dump($closure()); +?> +]]> + + &example.outputs; + + + + + + + パイプ演算子 + に渡す、引数を 1 つだけ受け取る callable は、部分適用で手軽に作れます。 + + + + <literal>|></literal> と部分適用を組み合わせる + + trim(...) + |> str_replace(' ', '', ?) + |> strtoupper(...) + |> str_pad(?, 12, '*', STR_PAD_BOTH); +?> +]]> + + &example.outputs; + + + + + + + Closure の引数の名前、型宣言、リファレンス渡しかどうかは、 + 元の関数のものを引き継ぎます。戻り値の型も同様です。 + 部分適用は、渡す引数自体が定数式であれば、定数式の中でも使えます。 + + + + 名前付きプレースホルダ + + + 引数は 名前付き引数 + で渡すこともでき、プレースホルダにも name: ? のように名前を付けられます。 + 通常の呼び出しと同じく、これらは位置を指定した引数の後に書かなければなりません。 + Closure の引数は名前付きプレースホルダを書いた順に並ぶので、 + 引数の順番を入れ替えられます。 + + + + 名前付きプレースホルダ + + +]]> + + &example.outputs; + + + + + + + + 引数の評価 + + + 部分適用で渡した引数は、Closure の生成時に 1 回だけ評価され、 + 呼び出すたびに評価し直されることはありません。 + 同じ呼び出しを アロー関数 + で包んだ場合とは、この点が異なります。アロー関数では、呼び出すたびに本体が評価されます。 + + + + 引数は <classname>Closure</classname> の生成時に評価される + + greet($name, now()); +echo "Arrow function created\n"; +echo $arrow('Alice'); + +$partial = greet(?, now()); +echo "Partial application created\n"; +echo $partial('Bob'); +?> +]]> + + &example.outputs; + + + + + + + + 余分な引数 + + + ... プレースホルダを使わない場合、 + Closure を呼び出すときに、その引数の数を超えて渡した引数は無視されます。 + 使った場合は、元の関数に渡されます。 + この違いが重要になるのは、Closure をコールバックとして受け取る関数が、 + 配列のキーなどを余分な引数としてコールバックに渡す場合です。 + ... を使うと、それらの値は元の関数の省略可能な引数に渡されます。 + + + + 余分な引数は <code>...</code> を使った場合のみ元の関数に渡される + + +]]> + + &example.outputs; + + + + + + + + 制限 + + + + + new Foo() は呼び出しとは見なされないため、 + 部分適用によるオブジェクトの生成 (例: new Foo(1, ?)) はサポートされていません。 + + + + + プレースホルダは、 + nullsafe 演算子 + と組み合わせて使えません。 + + + + + プレースホルダは、 + 引数の展開 + と組み合わせて使えません。 + + + + + compact、extract、 + func_get_args、get_defined_vars + など、呼び出し元のスコープを調べる関数は部分適用できません。 + Error がスローされます。 + + + + + + コンパイルエラーになる不正な使い方 + +method(1, ?); // Cannot combine nullsafe operator with Closure creation + +foo(?, ...$array); // Cannot combine partial application and unpacking + +foo(..., ?); // Variadic placeholder must be last +foo(a: 1, ?); // Cannot use positional argument after named argument +]]> + + + + + 渡した引数とプレースホルダの合計が、関数が受け取る引数の数と合わない場合、 + Closure の生成時に + ArgumentCountError がスローされます。 + + + + - + パイプ演算子 パイプ演算子 @@ -89,6 +89,35 @@ Array [7] => K [8] => S ) +]]> + + + + + PHP 8.6.0 以降では、 + 関数の部分適用 + により、複数の引数を取る関数にも、アロー関数を使わず値をパイプで渡せます。 + 左辺の値は、? プレースホルダの位置に入ります。 + + |> で部分適用を使う + + htmlentities(...) + |> str_split(...) + |> array_map(strtoupper(...), ?) + |> array_filter(?, fn($letter) => $letter != 'O') + |> implode('', ?) +; +echo $result, PHP_EOL; +?> +]]> + + &example.outputs; + + diff --git a/language/types/callable.xml b/language/types/callable.xml index b6866b7fb0..364bdd0991 100644 --- a/language/types/callable.xml +++ b/language/types/callable.xml @@ -1,6 +1,6 @@ - + コールバック / Callable @@ -73,6 +73,7 @@ function foo(callable $callback) { 無名関数、 アロー関数、 第一級callableを生成する記法、 + 関数の部分適用、 もしくは Closure::fromCallable メソッドを使って作成できます。 @@ -80,7 +81,9 @@ function foo(callable $callback) { 第一級callableを生成する記法 - は、PHP 8.1.0 以降でのみ利用可能です。 + は PHP 8.1.0 以降、 + 関数の部分適用 + は PHP 8.6.0 以降でのみ利用可能です。