ZLAG2C(3)

💅 ZLAG2C(3) — like, the whole manual, bestie

okay so this page lives at /home/abui...RC/zlag2c.f(3) and it's from the Library Functions Manual — very official, very demure 🎀

---

✨ NAME ✨

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/zlag2c.f

that's it. that's the name. it's literally just the whole file path, no notes, and honestly? iconic. 🫶

---

🌸 SYNOPSIS 🌸

Functions/Subroutines

subroutine ZLAG2C (m, n, a, lda, sa, ldsa, info)

ZLAG2C converts a complex double precision matrix to a complex single precision matrix. slay 💅

---

🦋 Function/Subroutine Documentation 🦋

subroutine ZLAG2C (integer m, integer n, complex*16, dimension( lda, * ) a,
    integer lda, complex, dimension( ldsa, * ) sa, integer ldsa, integer
    info)

again for the people in the back: ZLAG2C converts a complex double precision matrix to a complex single precision matrix. she's consistent, we love that 💖

🎀 Purpose

!>
!> ZLAG2C converts a COMPLEX*16 matrix, SA, to a COMPLEX matrix, A.
!>
!> RMAX is the overflow for the SINGLE PRECISION arithmetic
!> ZLAG2C checks that all the entries of A are between -RMAX and
!> RMAX. If not the conversion is aborted and a flag is raised.
!>
!> This is an auxiliary routine so there is no argument checking.
!>

bestie, quick vibe check on what that means: RMAX is the overflow threshold for SINGLE PRECISION arithmetic, and ZLAG2C goes through every entry of A making sure it's between -RMAX and RMAX. if something's out of bounds the conversion gets aborted and a flag gets raised — no cap, she will simply stop. 🛑

also, this is an auxiliary routine so there is no argument checking — she trusts you, she is not running a background check on your arguments, so please don't be messy with them 🙈

✨ Parameters

• M

!>          M is INTEGER
!>          The number of lines of the matrix A.  M >= 0.
!>

number of lines of the matrix A, and M >= 0 obviously 💅

• N

!>          N is INTEGER
!>          The number of columns of the matrix A.  N >= 0.
!>

number of columns of the matrix A, N >= 0, we stay non-negative in this house 🌈

• A

!>          A is COMPLEX*16 array, dimension (LDA,N)
!>          On entry, the M-by-N coefficient matrix A.
!>

it's a COMPLEX*16 array sized (LDA,N), and on entry it's the M-by-N coefficient matrix A. main character energy 👑

• LDA

!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,M).
!>

leading dimension of array A, and LDA >= max(1,M) — don't come in under that or it's giving undefined 😭

• SA

!>          SA is COMPLEX array, dimension (LDSA,N)
!>          On exit, if INFO=0, the M-by-N coefficient matrix SA; if
!>          INFO>0, the content of SA is unspecified.
!>

COMPLEX array, dimension (LDSA,N). on exit: if INFO=0 you get the M-by-N coefficient matrix SA — but if INFO>0, the content of SA is unspecified, so like… do not count on it, she's not promising anything 💀

• LDSA

!>          LDSA is INTEGER
!>          The leading dimension of the array SA.  LDSA >= max(1,M).
!>

leading dimension of array SA, LDSA >= max(1,M), same rule as before bestie, no shortcuts 🧚

• INFO

!>          INFO is INTEGER
!>          = 0:  successful exit.
!>          = 1:  an entry of the matrix A is greater than the SINGLE
!>                PRECISION overflow threshold, in this case, the content
!>                of SA in exit is unspecified.
!>

INFO is your report card:

• = 0 — successful exit, we ate 💅
• = 1 — an entry of the matrix A is greater than the SINGLE PRECISION overflow threshold, and in this case the content of SA on exit is unspecified. yeah. that one. 😭

👑 Author

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

academic baddies, all four of them 🎓✨

---

Definition at line 106 of file zlag2c.f. go look, it's right there 💜

---

🌟 Author 🌟

Generated automatically by Doxygen for LAPACK from the source code. not a human, just a very diligent little robot 🧚‍♀️

---

fr fr don't sleep on the INFO>0 case — if that flag is up, SA is a mystery box and you should not be reading from it. 🙈

---

okay that's the whole page!! mwah 💖 this was LAPACK, Version 3.12.0, dated /home/abui...RC/zlag2c.f(3) — catch you on the next manpage, bestie, bye!! 🦋🌸💅