<!-- Auto-generated — do not edit by hand -->
# Java Math Audit for PTC-Lisp

> **Warning:** This file is auto-generated by `mix ptc.gen_docs` from `priv/function_audit.exs`.
> Manual edits will be overwritten. Edit `priv/function_audit.exs` instead.

Comparison of `java.lang.Math` methods against PTC-Lisp builtins.

See also: [Function Reference](../function-reference.md) | [Clojure Core Audit](clojure-core-audit.md) | [Clojure String Audit](clojure-string-audit.md) | [Clojure Set Audit](clojure-set-audit.md) | [Clojure Walk Audit](clojure-walk-audit.md)

## Summary

| Status | Count |
|--------|-------|
| Supported | 8 |
| Candidate | 19 |
| Not Relevant | 22 |
| Not Classified | 0 |
| **Total** | **49** |

## Details

| Var | Status | Description | Notes |
|-----|--------|-------------|-------|
| `IEEEremainder` | ❌ not_relevant | Returns IEEE 754 remainder | low-level IEEE 754 semantics; use rem/mod |
| `abs` | ✅ supported | Returns the absolute value |  |
| `acos` | 🔲 candidate | Returns the arc cosine of a value | pure math |
| `addExact` | ❌ not_relevant | Returns sum, throwing on overflow | Java overflow semantics not applicable on BEAM |
| `asin` | 🔲 candidate | Returns the arc sine of a value | pure math |
| `atan` | 🔲 candidate | Returns the arc tangent of a value | pure math |
| `atan2` | 🔲 candidate | Returns angle theta from (x,y) to polar (r,theta) | pure math |
| `cbrt` | 🔲 candidate | Returns the cube root of a value | pure math |
| `ceil` | ✅ supported | Returns the smallest integer >= argument |  |
| `copySign` | ❌ not_relevant | Returns first arg with sign of second arg | low-level IEEE 754 manipulation |
| `cos` | 🔲 candidate | Returns the trigonometric cosine of an angle | pure math |
| `cosh` | 🔲 candidate | Returns the hyperbolic cosine of a value | pure math |
| `decrementExact` | ❌ not_relevant | Returns argument decremented by one, throwing on overflow | Java overflow semantics not applicable on BEAM |
| `exp` | 🔲 candidate | Returns Euler's number e raised to the power of a | pure math |
| `expm1` | ❌ not_relevant | Returns e^x - 1 | specialized numerical precision, low demand |
| `floor` | ✅ supported | Returns the largest integer <= argument |  |
| `floorDiv` | ❌ not_relevant | Returns floor of integer division | Java integer division semantics; use quot + floor |
| `floorMod` | ❌ not_relevant | Returns floor modulus of arguments | Java integer semantics; use mod |
| `fma` | ❌ not_relevant | Fused multiply-add | specialized numerical precision |
| `getExponent` | ❌ not_relevant | Returns unbiased exponent of a float/double | low-level IEEE 754 inspection |
| `hypot` | 🔲 candidate | Returns sqrt(x^2 + y^2) without intermediate overflow | pure math |
| `incrementExact` | ❌ not_relevant | Returns argument incremented by one, throwing on overflow | Java overflow semantics not applicable on BEAM |
| `log` | 🔲 candidate | Returns the natural logarithm (base e) of a value | pure math |
| `log10` | 🔲 candidate | Returns the base 10 logarithm of a value | pure math |
| `log1p` | ❌ not_relevant | Returns ln(1 + x) | specialized numerical precision, low demand |
| `max` | ✅ supported | Returns the greater of two values |  |
| `min` | ✅ supported | Returns the smaller of two values |  |
| `multiplyExact` | ❌ not_relevant | Returns product, throwing on overflow | Java overflow semantics not applicable on BEAM |
| `multiplyHigh` | ❌ not_relevant | Returns high 64 bits of 128-bit product | low-level 64-bit arithmetic |
| `negateExact` | ❌ not_relevant | Returns negation, throwing on overflow | Java overflow semantics not applicable on BEAM |
| `nextAfter` | ❌ not_relevant | Returns adjacent floating-point value | low-level IEEE 754 manipulation |
| `nextDown` | ❌ not_relevant | Returns adjacent floating-point value towards negative infinity | low-level IEEE 754 manipulation |
| `nextUp` | ❌ not_relevant | Returns adjacent floating-point value towards positive infinity | low-level IEEE 754 manipulation |
| `pow` | ✅ supported | Returns the value of a raised to the power of b |  |
| `random` | 🔲 candidate | Returns a pseudorandom double between 0.0 and 1.0 | pure (non-deterministic but side-effect free) |
| `rint` | ❌ not_relevant | Returns closest double to argument that is a mathematical integer | use round instead |
| `round` | ✅ supported | Returns the closest long/int to the argument |  |
| `scalb` | ❌ not_relevant | Returns d × 2^scaleFactor | low-level IEEE 754 manipulation |
| `signum` | 🔲 candidate | Returns the signum function of the argument | pure math |
| `sin` | 🔲 candidate | Returns the trigonometric sine of an angle | pure math |
| `sinh` | 🔲 candidate | Returns the hyperbolic sine of a value | pure math |
| `sqrt` | ✅ supported | Returns the positive square root of a value |  |
| `subtractExact` | ❌ not_relevant | Returns difference, throwing on overflow | Java overflow semantics not applicable on BEAM |
| `tan` | 🔲 candidate | Returns the trigonometric tangent of an angle | pure math |
| `tanh` | 🔲 candidate | Returns the hyperbolic tangent of a value | pure math |
| `toDegrees` | 🔲 candidate | Converts an angle from radians to degrees | pure math |
| `toIntExact` | ❌ not_relevant | Returns long narrowed to int, throwing on overflow | Java type narrowing not applicable on BEAM |
| `toRadians` | 🔲 candidate | Converts an angle from degrees to radians | pure math |
| `ulp` | ❌ not_relevant | Returns size of an ulp of the argument | low-level IEEE 754 inspection |
