BLAS/SRC/sscal.f(3)

📦
version 3.12.1 · 4 versions
, in arch rolling

💅 BLAS/SRC/sscal.f(3) — Library Functions Manual, but make it cute

okay bestie, so this is a manual page from the BLAS/SRC/sscal.f(3) corner of the universe (that "(3)" means it's a library function, iykyk). Buckle up, we're scaling vectors today and it's gonna slay ✨

🦋 NAME

BLAS/SRC/sscal.f — the file itself, main character energy, no notes 💅

🌸 SYNOPSIS

✨ Functions/Subroutines

  • subroutine sscal (n, sa, sx, incx) — the one and only SSCAL, here to do exactly one job and do it gorgeously

🎀 Function/Subroutine Documentation

subroutine sscal (integer n, real sa, real, dimension(*) sx, integer incx)

SSCAL 🫶

🌈 Purpose:

!>
!>    SSCAL scales a vector by a constant.
!>    uses unrolled loops for increment equal to 1.
!>

So real talk: SSCAL scales a vector by a constant — multiply-a-whole-vector-by-one-number type beat. And the glow-up? It uses unrolled loops for increment equal to 1, which is the compiler-girlie equivalent of showing up with a full beat face 👑

⭐ Parameters

  • N
!>          N is INTEGER
!>         number of elements in input vector(s)

N is INTEGER and it's literally the number of elements in input vector(s). She counts, she's organized, she's the planner friend 🗒️✨

  • SA
!>          SA is REAL
!>           On entry, SA specifies the scalar alpha.

SA is REAL. On entry, SA specifies the scalar alpha — that's the constant everything gets multiplied by. The alpha of the operation, fr fr 💜

  • SX
!>          SX is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) )

SX is a REAL array with dimension ( 1 + ( N - 1 )*abs( INCX ) ). Yes the formula is giving messy but that's the actual size, copy it exactly bestie, no rounding, no vibes-based math 🙈

  • INCX
!>          INCX is INTEGER
!>         storage spacing between elements of SX

INCX is INTEGER — the storage spacing between elements of SX. basically how far apart the elements are sitting in memory, like personal space for numbers 🫧

👑 Author

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

four absolute legends, all credited, all iconic 🏆

🔥 Further Details:

!>
!>     jack dongarra, linpack, 3/11/78.
!>     modified 3/93 to return if incx .le. 0.
!>     modified 12/3/93, array(1) declarations changed to array(*)
!>

the lore drop 🕰️ — jack dongarra, linpack, 3/11/78. then modified 3/93 to return if incx .le. 0. and later modified 12/3/93, array(1) declarations changed to array(*). historical document honestly, museum-worthy 💀✨

🌸 Definition

Definition at line 78 of file sscal.f. go look, she's there, line 78, being perfect 💖

🧚 Author

Generated automatically by Doxygen for LAPACK from the source code. not a human, a whole robot wrote this, and honestly? it ate 🤖💅

heads up bestie: the incx .le. 0. behaviour is documented above as a modification, and the array dimension formula ( 1 + ( N - 1 )*abs( INCX ) ) is the real deal — don't go improvising your own numbers, that's how you get undefined behaviour and a bad vibe check 😭

that's the whole page, no cap, every flag and every word accounted for 🫶

LAPACK — Version 3.12.0, dated with the BLAS/SRC/sscal.f(3) header energy — mwah, bye bestie, go scale something gorgeous 💜✨🎀

📦 where this page comes from