Constructors, assignment operators, and destructor

oneMKL - Data Parallel C++ Developer Reference

Download PDF

ID 772045

Date 6/30/2025

Version

Public

Constructors, assignment operators, and destructor

This page describes the constructors and destructor of the descriptor class template, which belongs to the oneapi::mkl::dft namespace and is declared in oneapi/mkl/dft.hpp (file to be included).

namespace oneapi::mkl::dft {
  template <precision prec, domain dom>
  class descriptor {
  public:
    // parameterized constructors:
    descriptor(std::vector<std::int64_t> dimensions);
    descriptor(std::int64_t length);
    // destructor:
    ~descriptor();
    // unsupported copy constructor and assignment operator:
    descriptor(const descriptor&) = delete;
    descriptor& operator=(const descriptor&) = delete;
    // move constructor and assignment operator:
    descriptor(descriptor&&);
    descriptor& operator=(descriptor&&);
  }
}

The usage of prepended namespace specifiers oneapi::mkl::dft is omitted below for conciseness.

Parameterized constructors

The parameterized constructors of any descriptor class allocate memory for an object’s data structures and default-configure it for the precision, forward domain, and length(s) of the transform it defines. These constructors do not trigger any significant computational work in preparation of the DFT that the object defines upon creation; all such tasks are operated when the object is committed to its DFT definition and to a given sycl::queue instance.

Input parameter

The input parameter of either constructor is detailed in the tables below. The tables use the notations presented in the introduction when referring to parameters of the DFT operation defined by the object.

Parameterized constructor’s input parameter for a `descriptor` object defining a one-dimensional DFT, *i.e.*, .
Name	Type	Description
`length`	`std::int64_t`	Value of (length of the one-dimensional DFT)

Parameterized constructor’s input parameter for any `descriptor` object.
Name	Type	Description
`lengths`	`std::vector<std::int64_t>`	Vector of size , containing , in that order (lengths of DFT)

Exceptions

The parameterized constructors may throw an std::runtime_error if

;
the construction of the descriptor object fails to allocate its required resources.

Copy constructor and assignment operator

Copy construction and assignment are not yet supported.

Move constructor and assignment operator

Descriptor objects can be move constructed and assigned. A moved-from descriptor must be reinitialized, e.g. via assignment, before reuse. Improper reuse of a moved-from descriptor may throw a oneapi::mkl::uninitialized exception.

Destructor

The destructor of any descriptor class frees all resources allocated for and by objects of that class.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

oneMKL - Data Parallel C++ Developer Reference

Constructors, assignment operators, and destructor

Parameterized constructors

Copy constructor and assignment operator

Move constructor and assignment operator

Destructor