vslConvCopyTask/vslCorrCopyTask

Copies a descriptor for convolution or correlation task.

Syntax

FORTRAN:

status = vslconvcopytask(newtask, srctask)

status = vslcorrcopytask(newtask, srctask)

C:

status = vslConvCopyTask(newtask, srctask);

status = vslCorrCopyTask(newtask, srctask);

Include Files

Input Parameters

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: 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 vslConvCopyTask/vslCorrCopyTask 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.


Submit feedback on this help topic