Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:128572
Precedence: list
MIME-Version: 1.0
References: <CANBC5npwi3azjJwf3p0mWeNpEWvKpY9yuNQreX3A6MJBAwFWPg@mail.gmail.com>
In-Reply-To: <CANBC5npwi3azjJwf3p0mWeNpEWvKpY9yuNQreX3A6MJBAwFWPg@mail.gmail.com>
Date: Wed, 27 Aug 2025 17:45:59 +0200
Message-ID: <CADyq6sKVyL=Ck_OeBwe+EQH1Lz0s_X1Qf3yM4H6cQg3sykMN_g@mail.gmail.com>
Subject: Re: [PHP-DEV] [RFC] [Discussion] Add clamp function
To: Kyle Katarn <kylekatarnls@gmail.com>
Cc: PHP Internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary="0000000000002ee358063d5ab0e8"
From: ocramius@gmail.com (Marco Pivetta)

--0000000000002ee358063d5ab0e8
Content-Type: text/plain; charset="UTF-8"

Hey Kyle,

On Wed, 27 Aug 2025 at 15:35, Kyle Katarn <kylekatarnls@gmail.com> wrote:

> Hello,
>
> I handled the feedback received on the draft RCF
> https://wiki.php.net/rfc/clamp_v2
>

I know this isn't very used in internals, but does it make sense to write
generics for the generated stubs of this function?

Specifically, I'd expect input, min and max to be bound to the same exact
type:

```php
/**
 * @template T
 * @param T $value
 * @param T $min
 * @param T $max
 * @return T
 */
function clamp (mixed $value, mixed $min, mixed $max): mixed {
   // ...
}
```

Greets,

Marco Pivetta

https://mastodon.social/@ocramius

https://ocramius.github.io/

--0000000000002ee358063d5ab0e8
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div>Hey Kyle,</div></div><br><div class=
=3D"gmail_quote gmail_quote_container"><div dir=3D"ltr" class=3D"gmail_attr=
">On Wed, 27 Aug 2025 at 15:35, Kyle Katarn &lt;<a href=3D"mailto:kylekatar=
nls@gmail.com">kylekatarnls@gmail.com</a>&gt; wrote:<br></div><blockquote c=
lass=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px soli=
d rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr">Hello,<div><br></div>=
<div>I handled the feedback received on the draft RCF=C2=A0<a href=3D"https=
://wiki.php.net/rfc/clamp_v2" target=3D"_blank">https://wiki.php.net/rfc/cl=
amp_v2</a></div></div></blockquote><div><br></div><div>I know this isn&#39;=
t very used in internals, but does it make sense to write generics for the =
generated stubs of this function?</div><div><br></div><div>Specifically, I&=
#39;d expect input, min and max to be bound to the same exact type:</div><d=
iv><br></div><div>```php</div><div>/**</div><div>=C2=A0*=C2=A0@template T<d=
iv></div><div>=C2=A0*=C2=A0@param T $value</div><div></div><div>=C2=A0*=C2=
=A0@param T $min<div></div><div>=C2=A0*=C2=A0@param T $max</div><div>=C2=A0=
*=C2=A0@return T</div><div>=C2=A0*/</div><div>function clamp (mixed $value,=
 mixed $min, mixed $max): mixed {</div><div>=C2=A0 =C2=A0// ...</div><div>}=
</div></div></div><div>```</div><div><br></div><div>Greets,</div><div>=C2=
=A0</div><div><div></div><div><div dir=3D"ltr" class=3D"gmail_signature"><d=
iv dir=3D"ltr">Marco Pivetta <br><br><a href=3D"https://mastodon.social/@oc=
ramius" target=3D"_blank">https://mastodon.social/@ocramius</a><br><br><a h=
ref=3D"https://ocramius.github.io/" target=3D"_blank">https://ocramius.gith=
ub.io/</a></div></div></div>=C2=A0</div></div></div>

--0000000000002ee358063d5ab0e8--