MA02HZ

Check if a matrix is a scalar multiple of an identity-like matrix (complex case)

Purpose

  To check if A = DIAG*I, where I is an M-by-N matrix with ones on
  the diagonal and zeros elsewhere, A is a complex matrix and DIAG
  is a complex scalar.

      LOGICAL FUNCTION MA02HZ( JOB, M, N, DIAG, A, LDA )
C     .. Scalar Arguments ..
      CHARACTER          JOB
      INTEGER            LDA, M, N
      COMPLEX*16         DIAG
C     .. Array Arguments ..
      COMPLEX*16         A(LDA,*)

  MA02HZ  LOGICAL
          The function value is set to .TRUE. if A = DIAG*I, and to
          .FALSE., otherwise. If min(M,N) = 0, the value is .FALSE.

Mode Parameters

  JOB     CHARACTER*1
          Specifies the part of the matrix A to be checked out,
          as follows:
          = 'U': Upper triangular/trapezoidal part;
          = 'L': Lower triangular/trapezoidal part.
          Otherwise:  All of the matrix A.

  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.

  DIAG   (input) COMPLEX*16
         The scalar DIAG.

  A      (input) COMPLEX*16 array, dimension (LDA,N)
         The leading M-by-N part of this array must contain the
         matrix A.  If JOB = 'U', only the upper triangle or
         trapezoid is accessed; if JOB = 'L', only the lower
         triangle or trapezoid is accessed.

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

  The routine returns immediately after detecting a diagonal element
  which differs from DIAG, or a nonzero off-diagonal element in the
  searched part of A.

  None

Program Text

  None

  None

  None