slatec-sys 0.1.0

Unsafe, provider-neutral Rust declarations for the reviewed SLATEC raw API
Documentation
# Purpose

Usage: DOUBLE PRECISION L1, L2, L3, M1, M2MIN, M2MAX, THRCOF(NDIM) INTEGER NDIM, IER CALL DRC3JM (L1, L2, L3, M1, M2MIN, M2MAX, THRCOF, NDIM, IER) Although conventionally the parameters of the vector addition coefficients satisfy certain restrictions, such as being integers or integers plus 1/2, the restrictions imposed on input to this subroutine are somewhat weaker. See, for example, Section 27.9 of Abramowitz and Stegun or Appendix C of Volume II of A. Messiah. The restrictions imposed by this subroutine are 1. L1.GE.ABS(M1) and L1+ABS(M1) must be an integer; 2. ABS(L1-L2).LE.L3.LE.L1+L2;

# Description

This canonical unsafe binding exposes original SLATEC routine `DRC3JM`. Its documented behavior is taken from the selected, source-hash-verified provider prologue; the exact implementation source is [DRC3JM](https://www.netlib.org/slatec/src/drc3jm.f).

# Arguments

## `L1`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 3j symbol. must be an integer;.

## `L2`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 3j symbol. must be an integer;.

## `L3`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 3j symbol. must be an integer;.

## `M1`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 3j symbol.

## `M2MIN`

**Direction:** `input-output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Smallest allowable M2 in 3j symbol. must be an integer, where.

## `M2MAX`

**Direction:** `input-output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Largest allowable M2 in 3j symbol. must be an integer, where MIN(L2,L3-M1) and M2MIN=MAX(-L2,-L3-M1). If the conventional restrictions are satisfied, then these restrictions are met. The user should be cautious in using input parameters that do not satisfy the conventional restrictions. For example, the the subroutine produces values of g(M2) = (0. 75 1.

## `THRCOF`

**Direction:** `output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** rank 1; dimensions (NDIM).

Set of 3j coefficients generated by evaluating the 3j symbol for all allowed values of M2. THRCOF(I) will contain g(M2MIN+I-1), I=1,2,. ,M2MAX-M2MIN+1.

## `NDIM`

**Direction:** `input`. **Fortran type:** `INTEGER`. **Rust ABI type:** `*mut crate::FortranInteger`. **Shape:** scalar.

Declared length of THRCOF in calling program.

## `IER`

**Direction:** `status-output`. **Fortran type:** `INTEGER`. **Rust ABI type:** `*mut crate::FortranInteger`. **Shape:** scalar.

Error flag. IER=0 No errors. IER=1 Either L1. LT. ABS(M1) or L1+ABS(M1) non-integer. IER=2 ABS(L1-L2).

# Return value

This is a Fortran subroutine and has no direct return value. Its results, status, and any persistent solver state are communicated through the documented arguments.

# Status and error values

| Status | Value | Meaning |
| --- | ---: | --- |
| `IER` | `0` | No errors. |
| `IER` | `1` | Either L1.LT.ABS(M1) or L1+ABS(M1) non-integer. |
| `IER` | `2` | ABS(L1-L2).LE.L3.LE.L1+L2 not satisfied. |
| `IER` | `3` | L1+L2+L3 not an integer. |
| `IER` | `4` | M2MAX-M2MIN not an integer. |
| `IER` | `5` | M2MAX less than M2MIN. |
| `IER` | `6` | NDIM less than M2MAX-M2MIN+1. |

# Workspace and array requirements

- `THRCOF`: not a workspace argument

# ABI notes

- Canonical Rust path: `slatec_sys::special::drc3jm`
- Original SLATEC routine: `DRC3JM`
- Native symbol: `drc3jm_`
- ABI fingerprint: `subroutine:void(mut_f64,mut_f64,mut_f64,mut_f64,mut_f64,mut_f64,mut_f64_ptr_rank1,mut_i32,mut_i32)`
- Exact Netlib source file: [DRC3JM](https://www.netlib.org/slatec/src/drc3jm.f)

# Safety

Every raw pointer must be non-null unless this argument contract expressly permits null, correctly aligned, and valid for its documented readable or writable extent. Preserve Fortran column-major layout, length, leading-dimension, workspace, callback-lifetime, aliasing, and provider-runtime requirements. The native routine does not retain ordinary argument pointers beyond this call.