Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
df?editptr df?EditPtr
Modifies a pointer to an array held in a Data Fitting task descriptor.
Syntax
status = dfseditptr ( task , ptr_attr , ptr )
status = dfdeditptr ( task , ptr_attr , ptr )
Include Files
mkl_df.f90
Input Parameters
Name |
Type |
Description |
|---|---|---|
task |
TYPE(DF_TASK) |
Descriptor of the task. |
ptr_attr |
INTEGER |
The parameter to change. For details, see the Pointer Attribute column in table “Pointers Supported by the df?EditPtr Task Editor” . |
ptr |
REAL(KIND=4) DIMENSION(*) for dfseditptr REAL(KIND=8) DIMENSION(*) for dfdeditptr |
New pointer. For details, see the Purpose column in table “Pointers Supported by the df?EditPtr Task Editor” . |
Output Parameters
Name |
Type |
Description |
|---|---|---|
status |
INTEGER |
Status of the routine:
|
Description
The df?editptrdf?EditPtr editor replaces the pointer of type ptr_attr stored in a Data Fitting task descriptor with a new pointer ptr . The table below describes types of pointers supported by the editor:
Pointers Supported by the df?EditPtr Task Editor
Pointer Attribute |
Purpose |
|---|---|
DF_X |
Partition x of the interpolation interval, an array of strictly sorted breakpoints. |
DF_Y |
Vector-valued function y |
DF_IC |
Internal conditions for spline construction. For details, see table “Internal Conditions Supported by Data Fitting Functions” . |
DF_BC |
Boundary conditions for spline construction. For details, see table “Boundary Conditions Supported by Data Fitting Functions” . |
DF_PP_SCOEFF |
Spline coefficients |
You can use df?editptrdf?EditPtr to modify different types of pointers including pointers to the vector-valued function and spline coefficients stored in contiguous memory. Use the df?editidxptrdf?EditIdxPtr editor if you need to modify pointers to coordinates of the vector-valued function or spline coefficients stored at non-contiguous memory locations.
If you modify a partition of the interpolation interval, then you should call the dfieditval task editor with the corresponding value of DF\_XHINT, even if the structure of the partition remains the same.
If you pass a NULL pointer to the df?editptrdf?EditPtr task editor, the task remains unchanged and the routine returns an error code. For the predefined error codes, please see “Task Status and Error Reporting” .