dotc¶
Computes the dot product of two complex vectors, conjugating the first vector.
Description
The dotc
routines perform a dot product between two complex
vectors, conjugating the first of them:
dotc
supports the following precisions for data.
T
std::complex<float>
std::complex<double>
dotc (Buffer Version)¶
Syntax
namespace oneapi::mkl::blas::column_major {
void dotc(sycl::queue &queue,
std::int64_t n,
sycl::buffer<T,1> &x,
std::int64_t incx,
sycl::buffer<T,1> &y,
std::int64_t incy,
sycl::buffer<T,1> &result)
}
namespace oneapi::mkl::blas::row_major {
void dotc(sycl::queue &queue,
std::int64_t n,
sycl::buffer<T,1> &x,
std::int64_t incx,
sycl::buffer<T,1> &y,
std::int64_t incy,
sycl::buffer<T,1> &result)
}
Input Parameters
- queue
The queue where the routine should be executed.
- n
The number of elements in vectors
x
andy
.- x
Buffer holding input vector
x
. The buffer must be of size at least (1 + (n
- 1)*abs(incx
)). See Matrix Storage for more details.- incx
The stride of vector
x
.- y
Buffer holding input vector
y
. The buffer must be of size at least (1 + (n
- 1)*abs(incy
)). See Matrix Storage for more details..- incy
The stride of vector
y
.
Output Parameters
- result
The buffer where the result (a scalar) is stored.
Throws
This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here.
dotc (USM Version)¶
Syntax
namespace oneapi::mkl::blas::column_major {
void dotc(sycl::queue &queue,
std::int64_t n,
const T *x,
std::int64_t incx,
const T *y,
std::int64_t incy,
T *result,
const sycl::vector_class<sycl::event> &dependencies = {})
}
namespace oneapi::mkl::blas::row_major {
void dotc(sycl::queue &queue,
std::int64_t n,
const T *x,
std::int64_t incx,
const T *y,
std::int64_t incy,
T *result,
const sycl::vector_class<sycl::event> &dependencies = {})
}
Input Parameters
- queue
The queue where the routine should be executed.
- n
The number of elements in vectors
x
andy
.- x
Pointer to input vector
x
. The array holding the input vectorx
must be of size at least (1 + (n
- 1)*abs(incx
)). See Matrix Storage for more details.- incx
The stride of vector
x
.- y
Pointer to input vector
y
. The array holding the input vectory
must be of size at least (1 + (n
- 1)*abs(incy
)). See Matrix Storage for more details..- incy
The stride of vector
y
.- dependencies
List of events to wait for before starting computation, if any. If omitted, defaults to no dependencies.
Output Parameters
- result
The pointer to where the result (a scalar) is stored.
Return Values
Output event to wait on to ensure computation is complete.
Throws
This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here.
oneapi::mkl::unsupported_device
Parent topic: BLAS Level 1 Routines