NAG Library Routine Document

1Purpose

f06jdf (zdscal) scales a complex vector by a real scalar.

2Specification

Fortran Interface
 Subroutine f06jdf ( n, x, incx)
 Integer, Intent (In) :: n, incx Real (Kind=nag_wp), Intent (In) :: alpha Complex (Kind=nag_wp), Intent (Inout) :: x(*)
#include nagmk26.h
 void f06jdf_ (const Integer *n, const double *alpha, Complex x[], const Integer *incx)
The routine may be called by its BLAS name zdscal.

3Description

f06jdf (zdscal) performs the operation
 $x←αx$
where $x$ is an $n$-element complex vector scattered with stride incx, and $\alpha$ is a real scalar.

4References

Lawson C L, Hanson R J, Kincaid D R and Krogh F T (1979) Basic linear algebra supbrograms for Fortran usage ACM Trans. Math. Software 5 308–325

5Arguments

1:     $\mathbf{n}$ – IntegerInput
On entry: $n$, the number of elements in $x$.
2:     $\mathbf{alpha}$ – Real (Kind=nag_wp)Input
On entry: the scalar $\alpha$.
3:     $\mathbf{x}\left(*\right)$ – Complex (Kind=nag_wp) arrayInput/Output
Note: the dimension of the array x must be at least $\mathrm{max}\phantom{\rule{0.125em}{0ex}}\left(1,1+\left({\mathbf{n}}-1\right)×{\mathbf{incx}}\right)$.
On entry: the $n$-element vector $x$. ${x}_{\mathit{i}}$ must be stored in ${\mathbf{x}}\left(1+\left(\mathit{i}-1\right)×{\mathbf{incx}}\right)$, for $\mathit{i}=1,2,\dots ,{\mathbf{n}}$.
Intermediate elements of x are not referenced.
On exit: the vector $\alpha x$ stored in the array elements used to supply the original vector $x$.
Intermediate elements of x are unchanged.
4:     $\mathbf{incx}$ – IntegerInput
On entry: the increment in the subscripts of x between successive elements of $x$.
Constraint: ${\mathbf{incx}}>0$.

None.

Not applicable.

8Parallelism and Performance

f06jdf (zdscal) is not threaded in any implementation.