Previous: zlartv Up: ../lapack-z.html Next: zlaset


zlascl


 NAME
      ZLASCL - multiply the M by N complex matrix A by the real
      scalar CTO/CFROM

 SYNOPSIS
      SUBROUTINE ZLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA,
                         INFO )

          CHARACTER      TYPE

          INTEGER        INFO, KL, KU, LDA, M, N

          DOUBLE         PRECISION CFROM, CTO

          COMPLEX*16     A( LDA, * )

 PURPOSE
      ZLASCL multiplies the M by N complex matrix A by the real
      scalar CTO/CFROM.  This is done without over/underflow as
      long as the final result CTO*A(I,J)/CFROM does not
      over/underflow. TYPE specifies that A may be full, upper
      triangular, lower triangular, upper Hessenberg, or banded.

 ARGUMENTS
      TYPE    (input) CHARACTER*1
              TYPE indices the storage type of the input matrix.
              = 'G':  A is a full matrix.
              = 'L':  A is a lower triangular matrix.
              = 'U':  A is an upper triangular matrix.
              = 'H':  A is an upper Hessenberg matrix.
              = 'B':  A is a symmetric band matrix with lower
              bandwidth KL and upper bandwidth KU and with the
              only the lower half stored.  = 'Q':  A is a sym-
              metric band matrix with lower bandwidth KL and upper
              bandwidth KU and with the only the upper half
              stored.  = 'Z':  A is a band matrix with lower
              bandwidth KL and upper bandwidth KU.

      KL      (input) INTEGER
              The lower bandwidth of A.  Referenced only if TYPE =
              'B', 'Q' or 'Z'.

      KU      (input) INTEGER
              The upper bandwidth of A.  Referenced only if TYPE =
              'B', 'Q' or 'Z'.

      CFROM   (input) DOUBLE PRECISION
              CTO     (input) DOUBLE PRECISION The matrix A is
              multiplied by CTO/CFROM. A(I,J) is computed without
              over/underflow if the final result CTO*A(I,J)/CFROM
              can be represented without over/underflow.  CFROM

              must be nonzero.

      M       (input) INTEGER
              The number of rows of the matrix A.  M >= 0.

      N       (input) INTEGER
              The number of columns of the matrix A.  N >= 0.

      A       (input/output) COMPLEX*16 array, dimension (LDA,M)
              The matrix to be multiplied by CTO/CFROM.  See TYPE
              for the storage type.

      LDA     (input) INTEGER
              The leading dimension of the array A.  LDA >=
              max(1,M).

      INFO    (output) INTEGER
              0  - successful exit <0 - if INFO = -i, the i-th
              argument had an illegal value.