.TH "Auxiliary BLAS" 3 "Wed Mar 8 2017" "Version 3.7.0" "LAPACK" \" -*- nroff -*- .ad l .nh .SH NAME Auxiliary BLAS \- .SS "Functions" .in +1c .ti -1c .RI "integer function \fBicamax\fP (\fBN\fP, CX, INCX)" .br .RI "\fI\fBICAMAX\fP \fP" .ti -1c .RI "integer function \fBidamax\fP (\fBN\fP, DX, INCX)" .br .RI "\fI\fBIDAMAX\fP \fP" .ti -1c .RI "integer function \fBisamax\fP (\fBN\fP, SX, INCX)" .br .RI "\fI\fBISAMAX\fP \fP" .ti -1c .RI "integer function \fBizamax\fP (\fBN\fP, ZX, INCX)" .br .RI "\fI\fBIZAMAX\fP \fP" .ti -1c .RI "logical function \fBlsame\fP (CA, CB)" .br .RI "\fI\fBLSAME\fP \fP" .ti -1c .RI "subroutine \fBxerbla\fP (SRNAME, INFO)" .br .RI "\fI\fBXERBLA\fP \fP" .ti -1c .RI "subroutine \fBxerbla_array\fP (SRNAME_ARRAY, SRNAME_LEN, INFO)" .br .RI "\fI\fBXERBLA_ARRAY\fP \fP" .in -1c .SH "Detailed Description" .PP This is the group of Auxiliary 3 BLAS routines\&. .SH "Function Documentation" .PP .SS "integer function icamax (integerN, complex, dimension(*)CX, integerINCX)" .PP \fBICAMAX\fP .PP \fBPurpose: \fP .RS 4 .PP .nf ICAMAX finds the index of the first element having maximum |Re(.)| + |Im(.)| .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP \fBFurther Details: \fP .RS 4 .PP .nf 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(*) .fi .PP .RE .PP .SS "integer function idamax (integerN, double precision, dimension(*)DX, integerINCX)" .PP \fBIDAMAX\fP .PP \fBPurpose: \fP .RS 4 .PP .nf IDAMAX finds the index of the first element having maximum absolute value. .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP \fBFurther Details: \fP .RS 4 .PP .nf 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(*) .fi .PP .RE .PP .SS "integer function isamax (integerN, real, dimension(*)SX, integerINCX)" .PP \fBISAMAX\fP .PP \fBPurpose: \fP .RS 4 .PP .nf ISAMAX finds the index of the first element having maximum absolute value. .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP \fBFurther Details: \fP .RS 4 .PP .nf 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(*) .fi .PP .RE .PP .SS "integer function izamax (integerN, complex*16, dimension(*)ZX, integerINCX)" .PP \fBIZAMAX\fP .PP \fBPurpose: \fP .RS 4 .PP .nf IZAMAX finds the index of the first element having maximum |Re(.)| + |Im(.)| .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP \fBFurther Details: \fP .RS 4 .PP .nf jack dongarra, 1/15/85. modified 3/93 to return if incx .le. 0. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "logical function lsame (characterCA, characterCB)" .PP \fBLSAME\fP .PP \fBPurpose: \fP .RS 4 .PP .nf LSAME returns .TRUE. if CA is the same letter as CB regardless of case. .fi .PP .RE .PP \fBParameters:\fP .RS 4 \fICA\fP .PP .nf CA is CHARACTER*1 .fi .PP .br \fICB\fP .PP .nf CB is CHARACTER*1 CA and CB specify the single characters to be compared. .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP .SS "subroutine xerbla (character*(*)SRNAME, integerINFO)" .PP \fBXERBLA\fP .PP \fBPurpose: \fP .RS 4 .PP .nf XERBLA is an error handler for the LAPACK routines. It is called by an LAPACK routine if an input parameter has an invalid value. A message is printed and execution stops. Installers may consider modifying the STOP statement in order to call system-specific exception-handling facilities. .fi .PP .RE .PP \fBParameters:\fP .RS 4 \fISRNAME\fP .PP .nf SRNAME is CHARACTER*(*) The name of the routine which called XERBLA. .fi .PP .br \fIINFO\fP .PP .nf INFO is INTEGER The position of the invalid parameter in the parameter list of the calling routine. .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP .SS "subroutine xerbla_array (character(1), dimension(srname_len)SRNAME_ARRAY, integerSRNAME_LEN, integerINFO)" .PP \fBXERBLA_ARRAY\fP .PP \fBPurpose: \fP .RS 4 .PP .nf 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. XERBLA_ARRAY then 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. .fi .PP .RE .PP \fBParameters:\fP .RS 4 \fISRNAME_ARRAY\fP .PP .nf SRNAME_ARRAY is CHARACTER(1) array, dimension (SRNAME_LEN) The name of the routine which called XERBLA_ARRAY. .fi .PP .br \fISRNAME_LEN\fP .PP .nf SRNAME_LEN is INTEGER The length of the name in SRNAME_ARRAY. .fi .PP .br \fIINFO\fP .PP .nf INFO is INTEGER The position of the invalid parameter in the parameter list of the calling routine. .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 December 2016 .RE .PP .SH "Author" .PP Generated automatically by Doxygen for LAPACK from the source code\&.