DLAMC3(3)

🎀 DLAMC3(3) — Library Functions Manual 🎀

okay so bestie, this is the DLAMC3(3) page from the Library Functions Manual — LAPACK dlamch.f energy, no cap. It's lowkey a tiny page but it's got layers. Let's go. 💖

🌸 NAME 🌸

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/INSTALL/dlamch.f

that's the path, literally. 🫶

✨ SYNOPSIS ✨

🦋 Functions/Subroutines 🦋

• double precision function DLAMCH (cmach) — the DLAMCH one
• double precision function DLAMC3 (a, b) — the DLAMC3 one

both double precision functions, both listed here in this exact order. 🌈

💖 Function/Subroutine Documentation 💖

🌟 double precision function DLAMC3 (double precision a, double precision b) 🌟

💫 DLAMC3 Purpose: 💫

the source says, literally:

!> DLAMC3  is intended to force  A  and  B  to be stored prior to doing
!> the addition of  A  and  B ,  for use in situations where optimizers
!> might hold one of these in a register.
!>

translation: it forces A and B to be stored before it does A + B, so optimizers can't stash one of them in a register. iconic behavior. 💅

👑 Author 👑

LAPACK is a software package provided by Univ. of Tennessee, Univ.
of California Berkeley, Univ. of Colorado Denver and NAG Ltd..

🎀 Parameters 🎀

A:

!>          A is a DOUBLE PRECISION
!>

B:

!>          B is a DOUBLE PRECISION
!>          The values A and B.
!>

💫 Purpose: 💫

yes, the source repeats the purpose block, so here it is again, exact:

!> DLAMC3  is intended to force  A  and  B  to be stored prior to doing
!> the addition of  A  and  B ,  for use in situations where optimizers
!> might hold one of these in a register.
!>

🎀 Parameters 🎀

• A
• B

!>          The values A and B.
!>

Definition at line 171 of file dlamch.f.

🌟 double precision function DLAMCH (character cmach) 🌟

DLAMCH DLAMCHF77 deprecated

🚨 deprecated alert, bestie: the source literally labels this one DLAMCH DLAMCHF77 deprecated. not a drill.

💫 Purpose: 💫

!>
!> DLAMCH determines double precision machine parameters.
!>

🎀 Parameters 🎀

CMACH:

!>          CMACH is CHARACTER*1
!>          Specifies the value to be returned by DLAMCH:
!>          = 'E' or 'e',   DLAMCH := eps
!>          = 'S' or 's ,   DLAMCH := sfmin
!>          = 'B' or 'b',   DLAMCH := base
!>          = 'P' or 'p',   DLAMCH := eps*base
!>          = 'N' or 'n',   DLAMCH := t
!>          = 'R' or 'r',   DLAMCH := rnd
!>          = 'M' or 'm',   DLAMCH := emin
!>          = 'U' or 'u',   DLAMCH := rmin
!>          = 'L' or 'l',   DLAMCH := emax
!>          = 'O' or 'o',   DLAMCH := rmax
!>          where
!>          eps   = relative machine precision
!>          sfmin = safe minimum, such that 1/sfmin does not overflow
!>          base  = base of the machine
!>          prec  = eps*base
!>          t     = number of (base) digits in the mantissa
!>          rnd   = 1.0 when rounding occurs in addition, 0.0 otherwise
!>          emin  = minimum exponent before (gradual) underflow
!>          rmin  = underflow threshold - base**(emin-1)
!>          emax  = largest exponent before overflow
!>          rmax  = overflow threshold  - (base**emax)*(1-eps)
!>

👑 Author 👑

• Univ. of Tennessee
• Univ. of California Berkeley
• Univ. of Colorado Denver
• NAG Ltd.

💫 Purpose: 💫

again, exact:

!>
!> DLAMCHF77 determines double precision machine parameters.
!>

🎀 Parameters 🎀

CMACH:

!>          CMACH is CHARACTER*1
!>          Specifies the value to be returned by DLAMCH:
!>          = 'E' or 'e',   DLAMCH := eps
!>          = 'S' or 's ,   DLAMCH := sfmin
!>          = 'B' or 'b',   DLAMCH := base
!>          = 'P' or 'p',   DLAMCH := eps*base
!>          = 'N' or 'n',   DLAMCH := t
!>          = 'R' or 'r',   DLAMCH := rnd
!>          = 'M' or 'm',   DLAMCH := emin
!>          = 'U' or 'u',   DLAMCH := rmin
!>          = 'L' or 'l',   DLAMCH := emax
!>          = 'O' or 'o',   DLAMCH := rmax
!>          where
!>          eps   = relative machine precision
!>          sfmin = safe minimum, such that 1/sfmin does not overflow
!>          base  = base of the machine
!>          prec  = eps*base
!>          t     = number of (base) digits in the mantissa
!>          rnd   = 1.0 when rounding occurs in addition, 0.0 otherwise
!>          emin  = minimum exponent before (gradual) underflow
!>          rmin  = underflow threshold - base**(emin-1)
!>          emax  = largest exponent before overflow
!>          rmax  = overflow threshold  - (base**emax)*(1-eps)
!>

👑 Author 👑

• Univ. of Tennessee
• Univ. of California Berkeley
• Univ. of Colorado Denver
• NAG Ltd.

Definition at line 68 of file dlamch.f.

✨ Author ✨

Generated automatically by Doxygen for LAPACK from the source code.

---

💖 cute sign-off: this page is from LAPACK Version 3.12.0, source path /home/abui...LL/dlamch.f(3). no date in the footer, so I'm not inventing one — periodt. 🫶