Visible to Intel only — GUID: GUID-80C3EDE8-D40A-48D2-A3E4-908622A6E88A
Visible to Intel only — GUID: GUID-80C3EDE8-D40A-48D2-A3E4-908622A6E88A
df?queryidxptr
Reads a pointer to the memory representing a coordinate of the data stored in matrix format.
Syntax
status = dfsqueryidxptr(task, ptr_attr, idx, ptr)
status = dfdqueryidxptr(task, ptr_attr, idx, ptr)
Include Files
- mkl_df.f90
Input Parameters
Name |
Type |
Description |
---|---|---|
task |
TYPE(DF_TASK) |
Descriptor of the task. |
ptr_attr |
INTEGER |
Pointer attribute to query. The parameter takes one of the attributes described in "Data Attributes Supported by the df?editidxptr Task Editor". |
idx |
INTEGER |
Index of the coordinate of the pointer to query. |
Output Parameters
Name |
Type |
Description |
---|---|---|
ptr |
INTEGER(KIND=8) |
Pointer to the data that holds values of coordinate idx returned. For details, see table "Data Attributes Supported by the df?editidxptr Task Editor". |
status |
INTEGER |
Status of the routine:
|
Description
The routine returns a pointer to the array that holds the idx coordinate of vector-valued function y or the pointer to the array of spline coefficients corresponding to the given coordinate.
You can use the query routine if you need the pointer to coordinates of the vector-valued function or spline coefficients held at non-contiguous memory locations or at a contiguous memory location in row-major format (the default storage format for spline coefficients).
Before calling this query routine, make sure that you have created and initialized the task using a task creation function or a relevant editor such as the generic or specific df?editppspline1d editor.
When using df?queryidxptr, you might receive an error code in the following cases:
You passed an unsupported parameter value into the editor.
The value of the index exceeds the predefined value that equals the dimension ny of the vector-valued function.
You request the pointer to the idx coordinate of the vector-valued function you provided to contiguous memory in column-major format.