# Purpose
Abstract *** a DOUBLE PRECISION routine *** DGAUS8 integrates real functions of one variable over finite intervals using an adaptive 8-point Legendre-Gauss algorithm. DGAUS8 is intended primarily for high accuracy integration or integration of smooth functions. The maximum number of significant digits obtainable in ANS is the smaller of 18 and the number of digits carried in double precision arithmetic.
# Description
This canonical unsafe binding exposes original SLATEC routine `DGAUS8`. Its documented behavior is taken from the selected, source-hash-verified provider prologue; the exact implementation source is [DGAUS8](https://www.netlib.org/slatec/src/dgaus8.f).
# Arguments
## `FUN`
**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.
name of external function to be integrated. This name must be in an EXTERNAL statement in the calling program. must be a DOUBLE PRECISION function of one DOUBLE PRECISION argument. The value of the argument to FUN is the variable of integration which ranges from A to B.
## `A`
**Direction:** `input-output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.
lower limit of integration B. -1 A and B are too nearly equal to allow normal integration. ANS is set to zero. --Abnormal code 2 ANS probably does not meet requested error tolerance.
## `B`
**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.
upper limit of integration (may be less than A).
## `ERR`
**Direction:** `input-output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.
is a requested pseudorelative error tolerance. Normally pick a value of ABS(ERR) so that DTOL. LT. ABS(ERR). LE. 1.
## `ANS`
**Direction:** `output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.
computed value of integral.
## `IERR`
**Direction:** `output`. **Fortran type:** `INTEGER`. **Rust ABI type:** `*mut crate::FortranInteger`. **Shape:** scalar.
a status code --Normal codes 1 ANS most likely meets requested error tolerance,.
# 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.
# ABI notes
- Canonical Rust path: `slatec_sys::quadrature::dgaus8`
- Original SLATEC routine: `DGAUS8`
- Native symbol: `dgaus8_`
- ABI fingerprint: `subroutine:void(mut_f64,mut_f64,mut_f64,mut_f64,mut_f64,mut_i32)`
- Exact Netlib source file: [DGAUS8](https://www.netlib.org/slatec/src/dgaus8.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.