CopyTask

Copies a descriptor for convolution or correlation task.

Syntax

Fortran:

status = vslconvcopytask(newtask, srctask)

status = vslcorrcopytask(newtask, srctask)

status = vslConvCopyTask(newtask, srctask);

status = vslCorrCopyTask(newtask, srctask);

Include Files

The FORTRAN 77 interfaces are specified in the mkl_vsl.f77 include file, the Fortran 90 interfaces are specified in the mkl_vsl.f90 include file, and the C interfaces are specified in the mkl_vsl_functions.h include file.

Input Parameters

Name	Type	Description
srctask	FORTRAN 77: INTEGER4 srctask(2) for vslconvcopytask INTEGER4 srctask(2) for vslcorrcopytask Fortran 90: TYPE(VSL_CONV_TASK) for vslconvcopytask TYPE(VSL_CORR_TASK) for vslcorrcopytask C: const VSLConvTaskPtr for vslConvCopyTask const VSLCorrTaskPtr for vslCorrCopyTask	Pointer to the source task descriptor.

Name

Type

Description

srctask

FORTRAN 77: INTEGER*4 srctask(2) for vslconvcopytask

INTEGER*4 srctask(2) for vslcorrcopytask

Fortran 90: TYPE(VSL_CONV_TASK) for vslconvcopytask

TYPE(VSL_CORR_TASK) for vslcorrcopytask

C: const VSLConvTaskPtr for vslConvCopyTask

const VSLCorrTaskPtr for vslCorrCopyTask

Pointer to the source task descriptor.

Output Parameters

Name	Type	Description
newtask	FORTRAN 77: INTEGER4 srctask(2) for vslconvcopytask INTEGER4 srctask(2) for vslcorrcopytask Fortran 90: TYPE(VSL_CONV_TASK) for vslconvcopytask TYPE(VSL_CORR_TASK) for vslcorrcopytask C: VSLConvTaskPtr* for vslConvCopyTask VSLCorrTaskPtr* for vslCorrCopyTask	Pointer to the new task descriptor.
status	FORTRAN 77: INTEGER Fortran 90: INTEGER C: int	Current status of the source task.

Name

Type

Description

newtask

FORTRAN 77: INTEGER*4 srctask(2) for vslconvcopytask

INTEGER*4 srctask(2) for vslcorrcopytask

Fortran 90: TYPE(VSL_CONV_TASK) for vslconvcopytask

TYPE(VSL_CORR_TASK) for vslcorrcopytask

C: VSLConvTaskPtr* for vslConvCopyTask

VSLCorrTaskPtr* for vslCorrCopyTask

Pointer to the new task descriptor.

status

FORTRAN 77: INTEGER

Fortran 90: INTEGER

C: int

Current status of the source task.

Description

If a task object srctask already exists, you can use an appropriate CopyTask routine to make its copy in newtask. After the copy operation, both source and new task objects will become committed (see Introduction to Convolution and Correlation for information about task commitment). If the source task was not previously committed, the commitment operation for this task is implicitly invoked before copying starts. If an error occurs during source task commitment, the task stores the error code in the status field. If an error occurs during copy operation, the routine returns a NULL pointer instead of a reference to a new task object.