Last commit related to Doxygen integration following Albert's comment
[platform/upstream/lapack.git] / SRC / clag2z.f
1 *> \brief \b CLAG2Z
2 *
3 *  =========== DOCUMENTATION ===========
4 *
5 * Online html documentation available at 
6 *            http://www.netlib.org/lapack/explore-html/ 
7 *
8 *> \htmlonly
9 *> Download CLAG2Z + dependencies 
10 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/clag2z.f"> 
11 *> [TGZ]</a> 
12 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/clag2z.f"> 
13 *> [ZIP]</a> 
14 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/clag2z.f"> 
15 *> [TXT]</a>
16 *> \endhtmlonly 
17 *
18 *  Definition
19 *  ==========
20 *
21 *       SUBROUTINE CLAG2Z( M, N, SA, LDSA, A, LDA, INFO )
22
23 *       .. Scalar Arguments ..
24 *       INTEGER            INFO, LDA, LDSA, M, N
25 *       ..
26 *       .. Array Arguments ..
27 *       COMPLEX            SA( LDSA, * )
28 *       COMPLEX*16         A( LDA, * )
29 *       ..
30 *  
31 *  Purpose
32 *  =======
33 *
34 *>\details \b Purpose:
35 *>\verbatim
36 *>
37 *> CLAG2Z converts a COMPLEX matrix, SA, to a COMPLEX*16 matrix, A.
38 *>
39 *> Note that while it is possible to overflow while converting
40 *> from double to single, it is not possible to overflow when
41 *> converting from single to double.
42 *>
43 *> This is an auxiliary routine so there is no argument checking.
44 *>
45 *>\endverbatim
46 *
47 *  Arguments
48 *  =========
49 *
50 *> \param[in] M
51 *> \verbatim
52 *>          M is INTEGER
53 *>          The number of lines of the matrix A.  M >= 0.
54 *> \endverbatim
55 *>
56 *> \param[in] N
57 *> \verbatim
58 *>          N is INTEGER
59 *>          The number of columns of the matrix A.  N >= 0.
60 *> \endverbatim
61 *>
62 *> \param[in] SA
63 *> \verbatim
64 *>          SA is COMPLEX array, dimension (LDSA,N)
65 *>          On entry, the M-by-N coefficient matrix SA.
66 *> \endverbatim
67 *>
68 *> \param[in] LDSA
69 *> \verbatim
70 *>          LDSA is INTEGER
71 *>          The leading dimension of the array SA.  LDSA >= max(1,M).
72 *> \endverbatim
73 *>
74 *> \param[out] A
75 *> \verbatim
76 *>          A is COMPLEX*16 array, dimension (LDA,N)
77 *>          On exit, the M-by-N coefficient matrix A.
78 *> \endverbatim
79 *>
80 *> \param[in] LDA
81 *> \verbatim
82 *>          LDA is INTEGER
83 *>          The leading dimension of the array A.  LDA >= max(1,M).
84 *> \endverbatim
85 *>
86 *> \param[out] INFO
87 *> \verbatim
88 *>          INFO is INTEGER
89 *>          = 0:  successful exit
90 *> \endverbatim
91 *>
92 *
93 *  Authors
94 *  =======
95 *
96 *> \author Univ. of Tennessee 
97 *> \author Univ. of California Berkeley 
98 *> \author Univ. of Colorado Denver 
99 *> \author NAG Ltd. 
100 *
101 *> \date November 2011
102 *
103 *> \ingroup complex16OTHERauxiliary
104 *
105 *  =====================================================================
106       SUBROUTINE CLAG2Z( M, N, SA, LDSA, A, LDA, INFO )
107 *
108 *  -- LAPACK auxiliary routine (version 3.3.1) --
109 *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
110 *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
111 *     November 2011
112 *
113 *     .. Scalar Arguments ..
114       INTEGER            INFO, LDA, LDSA, M, N
115 *     ..
116 *     .. Array Arguments ..
117       COMPLEX            SA( LDSA, * )
118       COMPLEX*16         A( LDA, * )
119 *     ..
120 *
121 *  =====================================================================
122 *
123 *     .. Local Scalars ..
124       INTEGER            I, J
125 *     ..
126 *     .. Executable Statements ..
127 *
128       INFO = 0
129       DO 20 J = 1, N
130          DO 10 I = 1, M
131             A( I, J ) = SA( I, J )
132    10    CONTINUE
133    20 CONTINUE
134       RETURN
135 *
136 *     End of CLAG2Z
137 *
138       END