df?editptr

Modifies a pointer to an array held in a Data Fitting task descriptor.

Syntax

Fortran:

status = dfseditptr(task, ptr_attr, ptr)

status = dfdeditptr(task, ptr_attr, ptr)

C:

status = dfsEditPtr(task, ptr_attr, ptr)

status = dfdEditPtr(task, ptr_attr, ptr)

Include Files

  • Fortran: mkl_df.f90
  • C: mkl.h

Input Parameters

Name

Type

Description

task

Fortran: TYPE(DF_TASK)

C: DFTaskPtr

Descriptor of the task.

ptr_attr

Fortran: INTEGER

C: 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

Fortran: REAL(KIND=4) DIMENSION(*) for dfseditptr

REAL(KIND=8) DIMENSION(*) for dfdeditptr

C: 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

Fortran: INTEGER

C: 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

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".

Note

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.

For more complete information about compiler optimizations, see our Optimization Notice.