slatec-sys 0.1.0

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

Written by L. F. Shampine and S. M. Davenport. The subroutine PVALUE uses the coefficients generated by POLFIT to evaluate the polynomial fit of degree L , along with the first

# Description

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

# Arguments

## `L`

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

the degree of polynomial to be evaluated. L may be any non-negative integer which is less than or equal to NDEG , the highest degree polynomial provided by POLFIT.

## `NDER`

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

of its derivatives, at a specified point. Computationally stable recurrence relations are used to perform this task. The parameters for PVALUE are the number of derivatives to be evaluated. NDER may be 0 or any positive value. If NDER is less than 0, it will be treated as 0.

## `X`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

the argument at which the polynomial and its derivatives are to be evaluated.

## `YFIT`

**Direction:** `output`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

value of the fitting polynomial of degree L at X.

## `YP`

**Direction:** `output`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** rank 1; dimensions (*).

array containing the first through NDER derivatives of the polynomial of degree L. YP must be dimensioned at least NDER in the calling program.

## `A`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** rank 1; dimensions (*).

work and output array containing values from last call to POLFIT.

# 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.

# Workspace and array requirements

- `YP`: not a workspace argument
- `A`: not a workspace argument

# ABI notes

- Canonical Rust path: `slatec_sys::approximation::pvalue`
- Original SLATEC routine: `PVALUE`
- Native symbol: `pvalue_`
- ABI fingerprint: `subroutine:void(mut_i32,mut_i32,mut_f32,mut_f32,mut_f32_ptr_rank1,mut_f32_ptr_rank1)`
- Exact Netlib source file: [PVALUE]https://www.netlib.org/slatec/src/pvalue.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.