Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 7/13/2023
Public

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

Document Table of Contents

?dotc

Computes a dot product of a conjugated vector with another vector.

Syntax

res = cdotc(n, x, incx, y, incy)

res = zdotc(n, x, incx, y, incy)

res = dotc(x, y)

Include Files

  • mkl.fi, blas.f90

Description

The ?dotc routines perform a vector-vector operation defined as:


Equation

where xi and yi are elements of vectors x and y.

Input Parameters

n

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

x

COMPLEX for cdotc

DOUBLE COMPLEX for zdotc

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

incx

INTEGER. Specifies the increment for the elements of x.

y

COMPLEX for cdotc

DOUBLE COMPLEX for zdotc

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

incy

INTEGER. Specifies the increment for the elements of y.

Output Parameters

res

COMPLEX for cdotc

DOUBLE COMPLEX for zdotc

Contains the result of the dot product of the conjugated x and unconjugated y, if n is positive. Otherwise, it contains 0.

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 dotc interface are the following:

x

Holds the vector with the number of elements n.

y

Holds the vector with the number of elements n.