quotientAndRemainderReportingOverflow(dividingBy:)

[oscbyspro]

Requested by (#84) and (#87). The former for performance and the latter for testability.

protocol ANKBinaryInteger {
    ....
    func quotientAndRemainderReportingOverflow(dividingBy divisor: Self) -> PVO<QR<Self, Self>>
}

protocol ANKLargeBinaryInteger {
    ....
    func quotientAndRemainderReportingOverflow(dividingBy divisor: Digit) -> PVO<QR<Self, Digit>>
}

[oscbyspro]

Note: I've had some success playing with the idea of "throwing overflow" vs "reporting overflow", but that's not really a design direction I can entertain without decoupling from the standard library. It might be a fun side project, however.

There's a lot of cool stuff you can do with this, especially considering that non-throwing methods can satisfy throwing method requirements. With throws you would only need one division method because you can simply try! to trap.

, hire me. I'm idea rich, but resource poor (｡•́︿•̀｡)

[oscbyspro]

Also, I wish the remainder part defaulted to the divisor rather than the dividend. It would be symmetric, in a way, because then I would not have to create some unrelated value in my digit methods (every valid remainder has a smaller magnitude than the divisor). Alternatively, if "reporting overflow" were "throwing" you wouldn't need to produce a junk value.

Edit: I suppose defaulting to the dividend makes sense when you consider mutating methods.

[oscbyspro]

7bcd36f Gotta add this method to ANKSigned too 🥱