New type converters suffixed by OrNull and OrThrow for NonZeroInt

[LVMVRQUXL]

Description

Like discussed in #104, we would like to introduce experimental builders for the NonZeroInt type that should:

• return null in case of a failure if the builder is suffixed by OrNull
• throw an IllegalArgumentException in case of a failure if the builder is suffixed by OrThrow.

These builders should work on all platforms and should be declared in the NonZeroInt.kt file after the toNonZeroInt function.
Their tests should be declared in the NonZeroIntTest class after the number_toNonZeroInt_should_fail_with_an_Int_that_equals_zero function.

Checklist

• Follow the Issue implementation section in the contributing guidelines until the Checking the API binaries section.
• Copy the Kotlin code below and paste it in the NonZeroInt.kt file.

Function signatures

/**
 * Returns this number as a [NonZeroInt], which may involve rounding or
 * truncation, or returns `null` if this number equals [zero][ZeroInt].
 *
 * Here's some usage examples:
 *
 * ```kotlin
 * var result: NonZeroInt? = 1.toNonZeroIntOrNull()
 * println(result) // 1
 *
 * result = 0.toNonZeroIntOrNull()
 * println(null) // 0
 * ```
 *
 * You can use the [toNonZeroIntOrThrow] function for throwing an
 * [IllegalArgumentException] instead of returning `null` when this number
 * equals [zero][ZeroInt].
 */
@ExperimentalNumberApi
@ExperimentalSinceKotoolsTypes("4.3.1")
public fun Number.toNonZeroIntOrNull(): NonZeroInt? {
    TODO()
}

/**
 * Returns this number as a [NonZeroInt], which may involve rounding or
 * truncation, or throws [IllegalArgumentException] if this number equals
 * [zero][ZeroInt].
 *
 * Here's some usage examples:
 *
 * ```kotlin
 * var result: NonZeroInt = 1.toNonZeroIntOrThrow()
 * println(result) // 1
 *
 * 0.toNonZeroIntOrThrow() // IllegalArgumentException
 * ```
 *
 * You can use the [toNonZeroIntOrNull] function for returning `null` instead
 * of throwing an [IllegalArgumentException] when this number equals
 * [zero][ZeroInt].
 */
@ExperimentalNumberApi
@ExperimentalSinceKotoolsTypes("4.3.1")
public fun Number.toNonZeroIntOrThrow(): NonZeroInt {
    TODO()
}

• Check your changes in the generated documentation.
• Check your changes in the public API binaries and update them.
• Copy the following Markdown code block and paste it in the Unreleased section in the CHANGELOG, replacing the YourGitHubProfile placeholder by your GitHub profile (see an example here).

Entry in changelog

### Added

**Experimental** builders suffixed by `OrNull` and `OrThrow` for the following
types:
- `NonZeroInt` (issue [#173] implemented by [@YourGitHubProfile](#)).

[#173]: https://github.com/kotools/types/issues/173

• Commit your local changes by running the git commit -a command in your terminal with the message below.

Commit message

feat(#173): add experimental builders for 'NonZeroInt'

New builders: 'toNonZeroIntOrNull' and 'toNonZeroIntOrThrow'.
These are not implemented yet.

• Implement the toNonZeroIntOrNull function by resolving the following tasks:
  • Add unit tests for this new function.
  • Run tests on the JVM platform. These should fail at this stage.
  • Implement this new function without changing its signature.
  • Run tests on the JVM platform. These should pass at this stage.
  • Commit your local changes by running the git commit -a command in your terminal with the message below.

Commit message

feat(#173): implement the 'toNonZeroIntOrNull' function

• Implement the toNonZeroIntOrThrow function by resolving the following tasks:
  • Add unit tests for this new function.
  • Run tests on the JVM platform. These should fail at this stage.
  • Implement this new function without changing its signature.
  • Run tests on the JVM platform. These should pass at this stage.
  • Commit your local changes by running the git commit -a command in your terminal with the message below.

Commit message

feat(#173): implement the 'toNonZeroIntOrThrow' function

• Create a Pull Request.

Maintainers only

• Refactor the construction of the type by using functional programming tools provided by Kotlin for improving its readability, composability and performance.

[LVMVRQUXL]

Done.