Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

?copy

Copies a vector to another vector.

Syntax

call scopy(n, x, incx, y, incy)

call dcopy(n, x, incx, y, incy)

call ccopy(n, x, incx, y, incy)

call zcopy(n, x, incx, y, incy)

call copy(x, y)

Include Files

  • mkl.fi, blas.f90

Description

The ?copy routines perform a vector-vector operation defined as

y = x,

where x and y are vectors.

Input Parameters

n

INTEGER. Specifies the number of elements in vectors x and y.

x

REAL for scopy

DOUBLE PRECISION for dcopy

COMPLEX for ccopy

DOUBLE COMPLEX for zcopy

Array, size at least (1 + (n-1)*abs(incx)).

incx

INTEGER. Specifies the increment for the elements of x.

y

REAL for scopy

DOUBLE PRECISION for dcopy

COMPLEX for ccopy

DOUBLE COMPLEX for zcopy

Array, size at least (1 + (n-1)*abs(incy)).

incy

INTEGER. Specifies the increment for the elements of y.

Output Parameters

y

Contains a copy of the vector x if n is positive. Otherwise, parameters are unaltered.

BLAS 95 Interface Notes

Routines in Fortran 95 interface have fewer arguments in the calling sequence than their FORTRAN 77 counterparts. For general conventions applied to skip redundant or reconstructible arguments, see BLAS 95 Interface Conventions.

Specific details for the routine copy interface are the following:

x

Holds the vector with the number of elements n.

y

Holds the vector with the number of elements n.