xerbla_array.f(3)

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

πŸ’… xerbla_array.f β€” LAPACK bestie edition ✨

okay so this page is straight out of the LAPACK manual (yes, the big one), and it's about one tiny little helper subroutine that's lowkey a legend. sit down, grab a strawberry drink πŸ“, and let's get into it.


✨ NAME ✨

xerbla_array.f β€” that's the file, that's the vibe. periodt.


πŸŽ€ SYNOPSIS πŸŽ€

Functions/Subroutines

  • subroutine xerbla_array (SRNAME_ARRAY, SRNAME_LEN, INFO) β€” XERBLA_ARRAY, the icon herself πŸ‘‘

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

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

XERBLA_ARRAY. no cap, that's the whole name.

πŸ’– Purpose πŸ’–

okay so here's the tea: XERBLA_ARRAY assists other languages in calling XERBLA, the LAPACK and BLAS error handler. it's literally the bridge friend 🫢.

so instead of 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. and if you call it with a non-positive SRNAME_LEN, XERBLA_ARRAY will call XERBLA with a string of all blank characters β€” like, an empty vibe, but make it legal πŸ™ˆ.

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);
}

and honestly? iconic.

🫧 heads up bestie: providing XERBLA_ARRAY is not necessary for intercepting LAPACK errors. XERBLA_ARRAY calls XERBLA. that's it, that's the whole relationship.

🌸 Parameters 🌸

  • SRNAME_ARRAY β€” CHARACTER(1) array, dimension (SRNAME_LEN). the name of the routine which called XERBLA_ARRAY. like a little name tag at a party πŸŽ€.
  • SRNAME_LEN β€” INTEGER. the length of the name in SRNAME_ARRAY. how many characters we're working with, fr fr.
  • INFO β€” INTEGER. the position of the invalid parameter in the parameter list of the calling routine. the culprit's seat number πŸ’€.

πŸ‘‘ Author πŸ‘‘

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

four whole institutions, main character energy 🌈.

⭐ Date ⭐

December 2016. vintage. retro. a classic πŸ’œ.


🧚 Definition 🧚

Definition at line 82 of file BLAS/SRC/xerbla_array.f.


πŸ“ Author πŸ“

Generated automatically by Doxygen for LAPACK from the source code. not a human, just a very efficient little robot πŸŽ€βœ¨.


and that's the whole page!! huge thank you to Version 3.8.0, dated Tue Nov 14 2017, for sponsoring this read πŸ’– slay, bye bestie πŸ‘‹πŸ’…

πŸ“¦ where this page comes from