Developer Reference

  • 2020.2
  • 07/15/2020
  • Public Content
Contents

df?editidxptr

Modifies a pointer to the memory representing a coordinate of the data stored in matrix format.

Syntax

status
=
dfseditidxptr
(
task
,
ptr_attr
,
idx
,
ptr
)
status
=
dfdeditidxptr
(
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
Type of the data to be modified.
The parameter takes one of the values described in
"Data Attributes Supported by the
df?editidxptr
Task Editor"
.
idx
INTEGER
Index of the coordinate whose pointer is to be modified.
ptr
REAL(KIND=4) DIMENSION(*)
for
dfseditidxptr
REAL(KIND=8) DIMENSION(*)
for
dfdeditidxptr
Pointer to the data that holds values of coordinate
idx
.
Output Parameters
Name
Type
Description
status
INTEGER
Status of the routine:
Description
The routine modifies 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 editor if you need to pass into a Data Fitting task or modify the pointer to coordinates of the vector-valued function or spline coefficients held at non-contiguous memory locations. Do not use the editor for coordinates at contiguous memory locations in row-major format.
Before calling this editor, 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.
Data Attributes Supported by the
df?editidxptr
Task Editor
Data Attribute
Description
DF_Y
Vector-valued function
y
DF_PP_SCOEFF
Piecewise polynomial spline coefficients
When using
df?editidxptr
, 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 pass a
    NULL
    pointer to the editor. In this case, the task remains unchanged.
  • You pass a pointer to the
    idx
    coordinate of the vector-valued function you provided to contiguous memory in column-major format.
The code example below demonstrates how to use the editor for providing values of a vector-valued function stored in two non-contiguous arrays: