feat: add min and max functions to the stdlib

[TomAFrench]

Description

Problem*

Resolves #4781

Summary*

This PR adds an equivalent to Rust's std::cmp:max and std::cmp::min https://doc.rust-lang.org/src/core/cmp.rs.html#1209

Additional Context

Documentation*

Check one:

• No documentation needed.
• Documentation included in this PR.
• [For Experimental Features] Documentation to be submitted in a separate PR.

PR Checklist*

• I have tested the changes locally.
• I have formatted the changes with Prettier and/or cargo fmt on default settings.

[jfecher]

Looks good. Just needs docs changes.

We may also want to consider adding these as a default method on the Cmp trait.

[TomAFrench]

We may also want to consider adding these as a default method on the Cmp trait.

I looked at implementing this but I'm getting a stack of errors related to the trait bound.

trait Ord {
    fn cmp(self, other: Self) -> Ordering;

    fn max(self, other: Self) -> Self {
        max(self, other)
    }
}

results in

No matching impl found for `T: Ord`
No matching impl found for `T: Ord`
No matching impl found for `A: Ord`
No matching impl found for `A: Ord`
No matching impl found for `A: Ord`
No matching impl found for `A: Ord`

[jfecher]

@TomAFrench ah, I guess we don't automatically assume Self: Trait within the definition for Trait.

Edit: Made an issue #4847

[TomAFrench]

Yep, lemme check if we have an issue for this already.

[TomAFrench]

Ah, too late.

[github-actions]

🚀 Deployed on https://66226938d6231508e42f24ea--noir-docs.netlify.app

[github-actions]

FYI @noir-lang/developerrelations on Noir doc changes.