LAPACK  3.4.1
LAPACK: Linear Algebra PACKage
xerbla_array.f
Go to the documentation of this file.
00001 *> \brief \b XERBLA_ARRAY
00002 *
00003 *  =========== DOCUMENTATION ===========
00004 *
00005 * Online html documentation available at 
00006 *            http://www.netlib.org/lapack/explore-html/ 
00007 *
00008 *> \htmlonly
00009 *> Download XERBLA_ARRAY + dependencies 
00010 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/xerbla_array.f"> 
00011 *> [TGZ]</a> 
00012 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/xerbla_array.f"> 
00013 *> [ZIP]</a> 
00014 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/xerbla_array.f"> 
00015 *> [TXT]</a>
00016 *> \endhtmlonly 
00017 *
00018 *  Definition:
00019 *  ===========
00020 *
00021 *       SUBROUTINE XERBLA_ARRAY( SRNAME_ARRAY, SRNAME_LEN, INFO)
00022 * 
00023 *       .. Scalar Arguments ..
00024 *       INTEGER SRNAME_LEN, INFO
00025 *       ..
00026 *       .. Array Arguments ..
00027 *       CHARACTER(1) SRNAME_ARRAY(SRNAME_LEN)
00028 *       ..
00029 *  
00030 *
00031 *> \par Purpose:
00032 *  =============
00033 *>
00034 *> \verbatim
00035 *>
00036 *> XERBLA_ARRAY assists other languages in calling XERBLA, the LAPACK
00037 *> and BLAS error handler.  Rather than taking a Fortran string argument
00038 *> as the function's name, XERBLA_ARRAY takes an array of single
00039 *> characters along with the array's length.  XERBLA_ARRAY then copies
00040 *> up to 32 characters of that array into a Fortran string and passes
00041 *> that to XERBLA.  If called with a non-positive SRNAME_LEN,
00042 *> XERBLA_ARRAY will call XERBLA with a string of all blank characters.
00043 *>
00044 *> Say some macro or other device makes XERBLA_ARRAY available to C99
00045 *> by a name lapack_xerbla and with a common Fortran calling convention.
00046 *> Then a C99 program could invoke XERBLA via:
00047 *>    {
00048 *>      int flen = strlen(__func__);
00049 *>      lapack_xerbla(__func__, &flen, &info);
00050 *>    }
00051 *>
00052 *> Providing XERBLA_ARRAY is not necessary for intercepting LAPACK
00053 *> errors.  XERBLA_ARRAY calls XERBLA.
00054 *> \endverbatim
00055 *
00056 *  Arguments:
00057 *  ==========
00058 *
00059 *> \param[in] SRNAME_ARRAY
00060 *> \verbatim
00061 *>          SRNAME_ARRAY is CHARACTER(1) array, dimension (SRNAME_LEN)
00062 *>          The name of the routine which called XERBLA_ARRAY.
00063 *> \endverbatim
00064 *>
00065 *> \param[in] SRNAME_LEN
00066 *> \verbatim
00067 *>          SRNAME_LEN is INTEGER
00068 *>          The length of the name in SRNAME_ARRAY.
00069 *> \endverbatim
00070 *>
00071 *> \param[in] INFO
00072 *> \verbatim
00073 *>          INFO is INTEGER
00074 *>          The position of the invalid parameter in the parameter list
00075 *>          of the calling routine.
00076 *> \endverbatim
00077 *
00078 *  Authors:
00079 *  ========
00080 *
00081 *> \author Univ. of Tennessee 
00082 *> \author Univ. of California Berkeley 
00083 *> \author Univ. of Colorado Denver 
00084 *> \author NAG Ltd. 
00085 *
00086 *> \date November 2011
00087 *
00088 *> \ingroup auxOTHERauxiliary
00089 *
00090 *  =====================================================================
00091       SUBROUTINE XERBLA_ARRAY( SRNAME_ARRAY, SRNAME_LEN, INFO)
00092 *
00093 *  -- LAPACK auxiliary routine (version 3.4.0) --
00094 *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
00095 *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
00096 *     November 2011
00097 *
00098 *     .. Scalar Arguments ..
00099       INTEGER SRNAME_LEN, INFO
00100 *     ..
00101 *     .. Array Arguments ..
00102       CHARACTER(1) SRNAME_ARRAY(SRNAME_LEN)
00103 *     ..
00104 *
00105 * =====================================================================
00106 *
00107 *     ..
00108 *     .. Local Scalars ..
00109       INTEGER I
00110 *     ..
00111 *     .. Local Arrays ..
00112       CHARACTER*32 SRNAME
00113 *     ..
00114 *     .. Intrinsic Functions ..
00115       INTRINSIC MIN, LEN
00116 *     ..
00117 *     .. External Functions ..
00118       EXTERNAL XERBLA
00119 *     ..
00120 *     .. Executable Statements ..
00121       SRNAME = ''
00122       DO I = 1, MIN( SRNAME_LEN, LEN( SRNAME ) )
00123          SRNAME( I:I ) = SRNAME_ARRAY( I )
00124       END DO
00125 
00126       CALL XERBLA( SRNAME, INFO )
00127 
00128       RETURN
00129       END
 All Files Functions