Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

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.h
Input Parameters
Name
Type
Description
task
DFTaskPtr
Descriptor of the task.
ptr_attr
const MKL_INT
The parameter to change.
For details, see the
Pointer Attribute
column in table
"Pointers Supported by the
df?EditPtr
Task Editor"
.
ptr
const float*
for
dfsEditPtr
const double*
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
int
Status of the routine:
Description
The
df?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.
The array must be strictly sorted. If it is unordered, the results of data fitting routines are not correct.
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?EditPtr
to modify different types of pointers including pointers to the vector-valued function and spline coefficients stored in contiguous memory. Use the
df?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?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".
You must preserve the arrays
x
(breakpoints),
y
(vector-valued functions),
bc
(boundary conditions),
ic
(internal conditions), and
scoeff
(spline coefficients) through the entire workflow of the Data Fitting computations which use those arrays, as the task stores the addresses of the arrays for spline-based computations.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804