[m-rev.] for review: add int32.clamp/3

[Julien Fischer]

On Wed, 4 Mar 2026 at 13:12, Julien Fischer <jfischer at opturion.com> wrote:
>
> On Wed, 4 Mar 2026 at 13:06, Peter Wang <novalazy at gmail.com> wrote:
> >
> > On Wed, 04 Mar 2026 12:13:37 +1100 Julien Fischer <jfischer at opturion.com> wrote:
> > > For review by anyone.
> > >
> > >  I intend to add the clamp/3 to all of the integer modules. I will add
> > > it for the others
> > > after this change is reviewed.
> > >
> > > -----------------------
> > >
> > > Add int32.clamp/3.
> > >
> > > library/int32.m:
> > >     Add the new function.
> >
> > > diff --git a/library/int32.m b/library/int32.m
> > > index bc8f526fa..6f4d6b73c 100644
> > > --- a/library/int32.m
> > > +++ b/library/int32.m
> > > @@ -189,6 +189,14 @@
> > >      %
> > >  :- func min(int32, int32) = int32.
> > >
> > > +    % clamp(Min, Max, N):
> > > +    %
> > > +    % Clamp N to the range [Min, Max] (inclusive).
> > > +    % Returns Min if N < Min, Max if N > Max, and N otherwise.
> > > +    % Throws an exception if Max < Min.
> > > +    %
> > > +:- func clamp(int32, int32, int32) = int32.
> > > +
> >
> > I suppose this is the obvious order for partial application.

Yes, partial application is the reason for this argument ordering.

....

> > The diff looks fine.

Thanks for that.

Julien.