Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:128575
Message-ID:
 <AM8P250MB0170F356F7768F77EF21D2B4E238A@AM8P250MB0170.EURP250.PROD.OUTLOOK.COM>
Date: Wed, 27 Aug 2025 18:48:16 +0200
User-Agent: Mozilla Thunderbird
Subject: Re: [PHP-DEV] [RFC] [Discussion] Add clamp function
To: Larry Garfield <larry@garfieldtech.com>,
 php internals <internals@lists.php.net>
References: <CANBC5npwi3azjJwf3p0mWeNpEWvKpY9yuNQreX3A6MJBAwFWPg@mail.gmail.com>
 <AM8P250MB0170D1704EDE7B573D306C7BE238A@AM8P250MB0170.EURP250.PROD.OUTLOOK.COM>
 <090b74db-6e29-489e-870e-4c1e336c7746@app.fastmail.com>
Content-Language: en-US
In-Reply-To: <090b74db-6e29-489e-870e-4c1e336c7746@app.fastmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Precedence: list
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: AM8P250MB0170:EE_|DB4P250MB0829:EE_
X-MS-Office365-Filtering-Correlation-Id: 7451e66e-1873-476e-b7ad-08dde5898589
X-MS-Exchange-SLBlob-MailProps:
	YfhX3sd/0TVWrg+fxRScxfg9v9HXnUFlvtnb1pc2lDzYYDPBhms1VIcwAH+8IoX0NAFyB2s6fT4fgB629nz+nlx0ma0C/m+QfwvsVBcrnSyxgaYxgjp0UCugJ5w5ots9khvHrpfZfncEEiQpOnKVBIx1cSE2pFA1t8gfbuvlx6Wm8inHL/jAPGTYIoGMcX/mKYEn2iK2S0LZceHESYa/5c0WAfzsoXXgOJT7eLCZN9EYV0yyUY+xSKNNZ2R288LGU/vnOHGbAUar9sSuDR1Md+mJybUzt1sU3qjjNsAR5zfOw2vblzsFJSZweVc3ikBIA+nutTl+G5DpFFDDByMluFKQ/uZSUXYr9UfE0tIsaszYiWrjRmIE6oE/vBLhklevwPW2yO+pFKIjyRSxwMH5FlRzW36XyTQkxukn1HklIlKYaYGETIkjBfkL/4FpyedhUpTkmF76lXxxscuUI34NsWtzieiEnbmIFdjmVQvwzFnddZ6zpeC5fxrIze4DD0xQZl8j8KUbA5tMAcSXXJY7132bzoRNSKNaVQPZsSBbNn7Wlwr6TZcgJb4mzV/RgH0Oc4453Bv1eF+2ILob7ZmdIdTVjsFIfshDAoqc1xKyNYlCxiTQ3d/KPgDYpnImzhqtJb55YsbZF6ZKG7Rf83FMqbuCbFuev+wD9fucDpTxh7AYSCvdt2V3ga2MFw/PeBAmSAhsXhqB2xcuT62KTJNATVkN9V4Pt10woR5CEKiWaksjNIDnqMdp0rOigQfXyTgUsKYIfxRs99AiiUd3o59A+2z1HK6ZXMS1BF8Wq1x56rU=
X-Microsoft-Antispam:
	BCL:0;ARA:14566002|8060799015|6090799003|5072599009|15080799012|23021999003|19110799012|461199028|10035399007|3412199025|40105399003|440099028|4302099013|26104999006|12091999003|1602099012;
X-Microsoft-Antispam-Message-Info:
	=?utf-8?B?R3RzK1FHSXZ0em1xY3FXcGVMdTdYZkVYZS83c3l4SEprZGFXR3c5MHBjSzRX?=
 =?utf-8?B?RUU5bWpHZ29SYjFNaUdwbm5HOCttYzFrSU1lbERYbEI0RGZYWGtMQzN3a28r?=
 =?utf-8?B?cGM5REprMmFDTklnV0NhS1k0ZFdRcjB5UHI0S0ovZEVSaDhHK2pucG9UekpM?=
 =?utf-8?B?WlZ4T3JrU3E0U0Nub3B6MWRad2pLa21xR2lIaDFyN2RpbHBLQW9sc3VLN0hS?=
 =?utf-8?B?VXNZeFNnRkJyLzVnaEFGS2RUZVpBbFI3VEVCN050R2l6YzJ3d3RuM0RIZkxS?=
 =?utf-8?B?Uk9oMCs2Tm1TczV5aW1WZ1I3SVNGaGYxUUdqeCtRK2FjcEw3dDB4Rk1ZM3Nh?=
 =?utf-8?B?M2RHaUdFc3JkeWpJM0VwV090T2FqVCtIOXZkN3RGN2JjTXNmWm1BeFIxTGRU?=
 =?utf-8?B?MUlRSGhaMDBPWU40VVJBczRhWnlOK3NaQ05aOEEySmkybzVWMWQrdGEyTGtz?=
 =?utf-8?B?MG1jMzEwNnlSYys5UXZYRnIycWM1K0xPQVdoWTZrUG5JSWxWZmUvYXJseXRq?=
 =?utf-8?B?dWVmSlhzN1ZKa2lPc3FDaGVCdzZlTnpyaGFGT3ZaL1FZcnBJVzVDZ1VKdzlT?=
 =?utf-8?B?QzQzWXQ0YkpDamlXWXR5QWswZGdIdUh2OXBRMGZ0UVpETk5Ka0FvQVVDTFZt?=
 =?utf-8?B?STQ5OGttWXZZRGNmTEc4YVRja3QyTDhyalFaUjRiZ3hWZ0RuenlXZThzczdq?=
 =?utf-8?B?NGx5a0ZrQ2pxNXh2d0h6L2duQmdqeEk2YmM1Q00zQVlKWit1SEVRRDE4RmlW?=
 =?utf-8?B?YjRaMHVDS3pMWU1xNVdYMzJEMWxBRitPRUdRMHZTZllYWm41Mlc5OSsyeGVD?=
 =?utf-8?B?SE9Fc2t1V0dLakFoWWpaVVNsbGlmK05PN2EwUi9jME9VLzVYdHZLTlRmc3A3?=
 =?utf-8?B?aEh4bWFkMmtuY3FzOXRNamEyaXQ2S1FheU9qaHR2LzB2QzFmZFZEbkZDRkVT?=
 =?utf-8?B?M09OMjRSNkt1d3J3ZWFrd3VOQXVOaGIrSStwdDE0LzVjVW9XYVNLV3QvK3B0?=
 =?utf-8?B?Y0ZBbXMvQXcxWXFZWHBvcWh3TlVhSzVFRkdXOGVyM043S05CV3lBVjlFWkdh?=
 =?utf-8?B?ZlQxL1Y3d1dudzVjM2szNXpvb0RmRFJUS0NJMlJjSlEvQjNzajg1OU02RW9i?=
 =?utf-8?B?RjZBNTNoZlBZZVU1QzlzdU1hVFRPRmNhVTdUMVdlSlMrV3ZDMjNXTjZxOFN5?=
 =?utf-8?B?YkhPRUU0T3BCYmJzblZRb042L3E3UTRJSlBBc0xMdVZTdW8wRWg1Vk1vOWth?=
 =?utf-8?B?T0JPKzR0MkxYTUoxYmJsc0FKZGY4ZWR5TDk0dHJoV1d3djdxUHRaYk1uY012?=
 =?utf-8?B?bjRhWk5EM0w4Ui9CZjk3OU0wd3IwcHlTVERBMlYzYTN5QkdJQnVYcnlidmxS?=
 =?utf-8?B?aHpDOEJZZ2xHNURXa1h5Qm5rUnM3ODBhRHlMWE1JWmpuT3d1NHQwK1k4dklT?=
 =?utf-8?B?TWpibkRncnlkYmpmUW9OZXBvcWo3dnRxUWRKaG9GUWZtRmpselpJSUtRcWds?=
 =?utf-8?B?Z0lRVjh6WW40MlVjNVdVUDUyY0pWcTEyZjZsQm5KTU5xK3lZOTNhdGdlNnhw?=
 =?utf-8?B?ZFNUTmc0bFkrdDJDM1RXRzZTbmM1MFVNbUxDVXdmZ3NzY2JxdExFbENLTGdu?=
 =?utf-8?B?bWNNNzV1azVnV1JmdFFJOHdmejNkU1ZVMXJjR1U1T2lqMmlVcUhGaDU4bmJk?=
 =?utf-8?B?aCtrNFJWa0VYb3JDMXEvTEE4L3JKWFFnWlQvSXZGZHJyYTN3d1FWWXlCcVF5?=
 =?utf-8?Q?IFvqudz43+JFS2sK+iIeQ3HWb4gR74IyE+p0eCA?=
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?OVNacWRkMjRENGtERW1Pb1daNFFXbkdtSTFwTjRadXRvUGRsOTYrQVF6TWY2?=
 =?utf-8?B?OUZYSG9oYVpGbGZwNEZpVk02enlESFRyS1NydFBpQk81WXRqQmVVbWp5TjFX?=
 =?utf-8?B?ZGFPQ25YTXBndHVydTBsSEFnTmhOYTJkUzBOcEZjOTUyQzRrV2hvTmwzSk43?=
 =?utf-8?B?QkY5eFRXNXV2V3RXVWlUQ0NmUThJclNzNnNXaHdmYXpsR3pTcXIxUXZoL1A4?=
 =?utf-8?B?UjQ2c1ZFeUQ4RkRjT1k4VDFXNFhxOVlKOHpuWDlCWHZIb2dtZHdzUkIxODFq?=
 =?utf-8?B?UzJpZlZRaUVKWUoxR2xKOXk0dC9nWllZbk1PLzZDUGZvbys4TnJNOTVXT3dz?=
 =?utf-8?B?MytabUZwdjZkZTF6Wkw3enFDZ0FteGtPYjRiMTFQVWdzMGl4cURCMmVOL0JI?=
 =?utf-8?B?R0lDZjF4d0pOZDJibE1sRXVjdHA5N2VNNjdBQTJ1ZjVHR0NXcTdYUjRVU2hh?=
 =?utf-8?B?a0xhbWVqTWhnRFkzcWhvbUVjUFdnd3JTbCtaV1A5MUFDeGhEQ05zODFrcUVT?=
 =?utf-8?B?VnNIZE9yTmw0WHQwTkd3MG9ZMFoxZ1M3cUs0djhtSFpFdW92cDB0NG9tcVV0?=
 =?utf-8?B?WkZlOXVUay95NVVJOEZOL29KZ0lOZ2NvS0FZeTVxVGlWYnlrSUFZZFlSU2VQ?=
 =?utf-8?B?YUJqcnY2SXlQMjVVTGtOT3RFQVF4UUpqdjNveDBFRkd3a0swQ0ZLQlp3UEli?=
 =?utf-8?B?WjBEVTk0RVAveWxaL2ZVVEtiUVZNcXF0VnlmU1RyYzN3dUJVY1NTUmVGZlBu?=
 =?utf-8?B?eFdzQU1Hd1VoYTdhcFZoMUw4ckhETkR0T3FBUEErUjVBMWZvZkdMajlkMU1K?=
 =?utf-8?B?T3BOVHZaUHNDNEJTZUZ6OG1PNlR6YTU1cmVIMmFpUy9TekJwVTBaKzl4V3gv?=
 =?utf-8?B?bEdnSFRaUFpUdmpxRFd5NG1saVJONVg1b1FITHBScDRDRFpubUtZbHBwbE1l?=
 =?utf-8?B?T01DYU92UnhzQlFZSXk4YU91NXhOc290UXFZMXZCeGR0cktvMkJaRTJ6WTBD?=
 =?utf-8?B?Y091M3pLQ0I1Qkg3Ti9CSmNBeEdyRUtPSXk1L1BjaEI5NGtGS2tCT3UyK0ZR?=
 =?utf-8?B?cXB0Q0cvTkpXc0Jna3RGRWxZWTlFK05tTTlaSEhrSlgyeE9SVmRsa1hHT1Q4?=
 =?utf-8?B?SG5yRUYvWThTaTl2QjZUaVZuT3dEUE42aVNCMWlneHg3TlViWkJPR2pwK2NI?=
 =?utf-8?B?b0I3RXdBQUVjTm5VMFVPU2FoaGZQTUhWeEFOejk1WHg0RWNvMkZyUE5wNDZy?=
 =?utf-8?B?VkU3RTRFYVE1SkJLZWNuSXM1eDM1NUtVdHVlTGhiMzRzUG83bktUWXBzcGwr?=
 =?utf-8?B?aFBSNFY0UDFzeEdSK1VmTURkS2Z5cVBCL2NpKzBYUUQrQnI5WFRzSVdWYWo1?=
 =?utf-8?B?ejRmYnVUbG1mM1hqa2JCUkRpSWtIZk1NWU9jTjVlcjRCL3Z5RStxVmk5aWhr?=
 =?utf-8?B?akU2djhpamtpNzNseGUydnVjNmRlWTJZaE00K29kaGN6YUF1N0JwQVNSdGs2?=
 =?utf-8?B?aC92NWdPWS91VFArTWNZbU9TZktRZTAyYzB2eFpEN2NtRUNlUHRuZ2YweXpI?=
 =?utf-8?B?ZStNNUcwaDZKdHVIdFJYNzVReHNicVVVMzRsaE55c1dybzFzZ2ZieDd0U0Rx?=
 =?utf-8?B?eVV6cFpzakoxazBNb251ZWZPbElKREpIaGpjVlRBaGhuOUdYN1pkTWdrOEls?=
 =?utf-8?B?Q0hOS011S0dCS1loNGtJc0R1RzNYV0VBNDl0TnN3Rmt6YVBadjkyQ1Mza2pZ?=
 =?utf-8?Q?P5mjDQLFD+QMnEtNW8=3D?=
X-OriginatorOrg: sct-15-20-8534-15-msonline-outlook-5f066.templateTenant
X-MS-Exchange-CrossTenant-Network-Message-Id: 7451e66e-1873-476e-b7ad-08dde5898589
X-MS-Exchange-CrossTenant-AuthSource: AM8P250MB0170.EURP250.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Aug 2025 16:48:17.4993
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg:
	00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB4P250MB0829
From: bobwei9@hotmail.com (Bob Weinand)

Thanks Larry!

On 27.8.2025 18:40:51, Larry Garfield wrote:
> On Wed, Aug 27, 2025, at 11:06 AM, Bob Weinand wrote:
>> Hey,
>>
>> On 27.8.2025 15:34:53, Kyle Katarn wrote:
>>> Hello,
>>>
>>> I handled the feedback received on the draft RCF https://wiki.php.net/rfc/clamp_v2
>>>
>>> If I didn't forget anything this should be now ready for discussion. So I updated its status.
>>>
>>> There is an implementation proposal: https://github.com/php/php-src/pull/19434
>>> And some draft for documentation here: https://github.com/php/doc-en/pull/4814
>>>
>>> Thanks,
>>
>> As others have noted before, what's the motivation of having the
>> to-be-clamped value as first parameter rather than infixed between min
>> and max?
>>
>> E.g. from CSS: https://developer.mozilla.org/en-US/docs/Web/CSS/clamp:
>>
>> `clamp(min, val, max)`
>>
>> Feels to me as the most natural order, too.
>>
>>
>>
>> You mention it was taken from the first RFC, but that one also did not
>> discuss the ordering in the first place either.
> Some quick data points from momentary googling:
>
> CSS: clamp(min, val, max)
>
> Python: clamp(val, min, max)
> C++: clamp(val, min, max)
> Java: clamp(val, in, max)
> Javascript: clamp(val, min, max)
> C#: clamp(val, min, max)
>
> Kotlin: val.clamp(min, max) (as an extension function)
> Ruby: val.clamp(min, max)
>
> So it looks like CSS is the oddball here.  We should follow the clear majority approach.  (Kyle, feel free to include this in the RFC.)
>
> --Larry Garfield


Indeed, that makes sense then. I must admit that I've only ever been 
using the clamp from CSS, but never from other languages. (I still think 
value in the middle makes more sense, but I guess that's me then, and I 
won't object.)

Then yes, please note it in the RFC :-)


Bob