Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
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

cblas_?axpby

Scales two vectors, adds them to one another and stores result in the vector.

Syntax

void cblas_saxpby (const MKL_INT n, const float a, const float *x, const MKL_INT incx, const float b, float *y, const MKL_INT incy);

void cblas_daxpby (const MKL_INT n, const double a, const double *x, const MKL_INT incx, const double b, double *y, const MKL_INT incy);

void cblas_caxpby (const MKL_INT n, const void *a, const void *x, const MKL_INT incx, const void *b, void *y, const MKL_INT incy);

void cblas_zaxpby (const MKL_INT n, const void *a, const void *x, const MKL_INT incx, const void *b, void *y, const MKL_INT incy);

Include Files

  • mkl.h

Description

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

y := a*x + b*y

where:

a and b are scalars

x and y are vectors each with n elements.

Input Parameters

n

Specifies the number of elements in vectors x and y.

a

Specifies the scalar a.

x

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

incx

Specifies the increment for the elements of x.

b

Specifies the scalar b.

y

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

incy

Specifies the increment for the elements of y.

Output Parameters

y

Contains the updated vector y.

Example

For examples of routine usage, see these code examples in the Intel® oneAPI Math Kernel Library (oneMKL) installation directory:

  • cblas_saxpby: examples\cblas\source\cblas_saxpbyx.c

  • cblas_daxpby: examples\cblas\source\cblas_daxpbyx.c

  • cblas_caxpby: examples\cblas\source\cblas_caxpbyx.c

  • cblas_zaxpby: examples\cblas\source\cblas_zaxpbyx.c