xerbla_array.f(3)

πŸ“¦ version 3.9.0, in centos-stream 9

πŸŽ€ NAME πŸŽ€

xerbla_array.f β€” this is the whole page, bestie, and it's from the LAPACK manual. It's all about the xerbla_array function/subroutine. ✨

🌈 SYNOPSIS 🌈

Functions/Subroutines

  • subroutine xerbla_array (SRNAME_ARRAY, SRNAME_LEN, INFO) β€” the one and only XERBLA_ARRAY, slay.

πŸ¦‹ Function/Subroutine Documentation πŸ¦‹

subroutine xerbla_array (character(1), dimension(srname_len) SRNAME_ARRAY, integer SRNAME_LEN, integer INFO)

XERBLA_ARRAY β€” okay so this is the full signature, and it's giving exactly what it needs to give. πŸ’…

🌸 Purpose

XERBLA_ARRAY assists other languages in calling XERBLA, the LAPACK and BLAS error handler. Rather than taking a Fortran string argument as the function's name, XERBLA_ARRAY takes an array of single characters along with the array's length. Then XERBLA_ARRAY copies up to 32 characters of that array into a Fortran string and passes that to XERBLA. If called with a non-positive SRNAME_LEN, XERBLA_ARRAY will call XERBLA with a string of all blank characters. 🫢

Say some macro or other device makes XERBLA_ARRAY available to C99 by a name lapack_xerbla and with a common Fortran calling convention. Then a C99 program could invoke XERBLA via:

               {
                 int flen = strlen(__func__);
                 lapack_xerbla(__func__, &flen, &info);
               }

Providing XERBLA_ARRAY is not necessary for intercepting LAPACK errors. XERBLA_ARRAY calls XERBLA. No cap. 🧚

πŸŽ€ Parameters

  • SRNAME_ARRAY β€” SRNAME_ARRAY is CHARACTER(1) array, dimension (SRNAME_LEN). It's the name of the routine which called XERBLA_ARRAY.
  • SRNAME_LEN β€” SRNAME_LEN is INTEGER. It's the length of the name in SRNAME_ARRAY.
  • INFO β€” INFO is INTEGER. It's the position of the invalid parameter in the parameter list of the calling routine.

πŸ‘‘ Author

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

πŸ“ Date

December 2016 β€” iconic.

Definition at line 92 of file SRC/xerbla_array.f.

πŸ’œ Author

Generated automatically by Doxygen for LAPACK from the source code. That's the meta-author, bestie, not the people above. πŸ™ˆ


Cute little sign-off: this page comes from LAPACK source, version 3.8.0, dated Tue Nov 14 2017, and its title/manual line is xerbla_array.f(3) from the LAPACK manual. Bye bestie, go be a main character with XERBLA_ARRAY! πŸ’–βœ¨

πŸ“¦ where this page comes from