ZSWAP(3)

💅 ZSWAP(3) — or, the girlies are swapping vectors 💖

okay so real talk: this page is from the LAPACK library functions manual, and the file it's documenting lives at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/BLAS/SRC/zswap.f ✨ (yes that's a whole path, yes I'm gonna say it exactly, no I will not be shortening it, it's giving very "deep in the build tree" energy 🫶).

---

✨ SYNOPSIS ✨

Functions/Subroutines 🌸

subroutine ZSWAP (n, zx, incx, zy, incy)

bestie. that's it. that's the subroutine. it's called ZSWAP and honestly it ate 💅

---

🦋 Function/Subroutine Documentation 🦋

subroutine ZSWAP (integer n, complex*16, dimension(*) zx, integer incx,
    complex*16, dimension(*) zy, integer incy)

ZSWAP 👑 — the main character of this whole page, no cap.

🎀 Purpose: 🎀

!>
!>    ZSWAP interchanges two vectors.
!>

literally all it does: ZSWAP interchanges two vectors. swap city, population: your two vectors 🌈 that's the whole vibe. iconic behavior tbh.

💜 Parameters

N

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

N is INTEGER — it's the number of elements in your input vector(s) 🍓 like, how many of them are we swapping, bestie? this many.

ZX

!>          ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
!>

ZX is a COMPLEX*16 array — dimension ( 1 + ( N - 1 )*abs( INCX ) ) ✨ write that formula down, it's important, I'm not even joking 🙈

INCX

!>          INCX is INTEGER
!>         storage spacing between elements of ZX
!>

INCX is INTEGER — it's the storage spacing between elements of ZX 🌸 so like, are we walking through ZX one at a time or doing little skips? that's INCX's job.

ZY

!>          ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) )
!>

ZY is a COMPLEX*16 array — dimension ( 1 + ( N - 1 )*abs( INCY ) ) 💖 notice it's INCY this time, not INCX, because ZY is its own girl and has its own spacing 💅

INCY

!>          INCY is INTEGER
!>         storage spacing between elements of ZY
!>

INCY is INTEGER — the storage spacing between elements of ZY 🦋 same deal as INCX but for the other vector, periodt.

⭐ Author

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

the whole academic squad showed up for this one 🫶👑

🔥 Further Details:

!>
!>     jack dongarra, 3/11/78.
!>     modified 12/3/93, array(1) declarations changed to array(*)
!>

ngl this is the lore drop 💀 — jack dongarra, 3/11/78, and then modified 12/3/93 where array(1) declarations were changed to array(*) 🌟 vintage code, still slaying.

Definition at line 80 of file zswap.f 📍 (yes, line 80, exactly, I would never lie to you).

---

💫 Author (the meta one) 💫

Generated automatically by Doxygen for LAPACK from the source code 🤖✨ so nobody hand-wrote this page, a robot did it for us and honestly? respect.

---

ok that's the whole page bestie 💀 no extra options, no hidden flags, no surprises — just one little swap subroutine living its truth. don't go inventing parameters that aren't here, iykyk 🙈

---

and that's a wrap, babe 🎀 — LAPACK, Version 3.12.0, page pulled from /home/abui...SRC/zswap.f(3) 🦋 mwah, go swap something pretty 💅💖