# dlascl.f man page

dlascl.f —

## Synopsis

### Functions/Subroutines

subroutinedlascl(TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO)DLASCLmultiplies a general rectangular matrix by a real scalar defined as cto/cfrom.

## Function/Subroutine Documentation

### subroutine dlascl (characterTYPE, integerKL, integerKU, double precisionCFROM, double precisionCTO, integerM, integerN, double precision, dimension( lda, * )A, integerLDA, integerINFO)

**DLASCL** multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.

**Purpose:**

```
DLASCL multiplies the M by N real 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.
```

**Parameters:**

*TYPE*

```
TYPE is 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 symmetric 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. See DGBTRF for storage details.
```

*KL*

```
KL is INTEGER
The lower bandwidth of A. Referenced only if TYPE = 'B',
'Q' or 'Z'.
```

*KU*

```
KU is INTEGER
The upper bandwidth of A. Referenced only if TYPE = 'B',
'Q' or 'Z'.
```

*CFROM*

`CFROM is DOUBLE PRECISION`

*CTO*

```
CTO is 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*

```
M is INTEGER
The number of rows of the matrix A. M >= 0.
```

*N*

```
N is INTEGER
The number of columns of the matrix A. N >= 0.
```

*A*

```
A is DOUBLE PRECISION array, dimension (LDA,N)
The matrix to be multiplied by CTO/CFROM. See TYPE for the
storage type.
```

*LDA*

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

*INFO*

```
INFO is INTEGER
0 - successful exit
<0 - if INFO = -i, the i-th argument had an illegal value.
```

**Author:**

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

**Date:**

September 2012

Definition at line 140 of file dlascl.f.

## Author

Generated automatically by Doxygen for LAPACK from the source code.

## Referenced By

dlascl(3) is an alias of dlascl.f(3).

Sat Nov 16 2013 Version 3.4.2 LAPACK