CopyStream

Creates a copy of a random stream.

Syntax

Fortran:

status = vslcopystream( newstream, srcstream )

status = vslCopyStream( &newstream, srcstream );

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
srcstream	FORTRAN 77: INTEGER4 srcstream(2) Fortran 90:* TYPE(VSL_STREAM_STATE), INTENT(IN) C: const VSLStreamStatePtr	Fortran: Descriptor of the stream to be copied C: Pointer to the stream state structure to be copied

Name

Type

Description

srcstream

FORTRAN 77: INTEGER*4 srcstream(2)

Fortran 90: TYPE(VSL_STREAM_STATE), INTENT(IN)

C: const VSLStreamStatePtr

Fortran: Descriptor of the stream to be copied

C: Pointer to the stream state structure to be copied

Output Parameters

Name	Type	Description
newstream	FORTRAN 77: INTEGER4 newstream(2) Fortran 90:* TYPE(VSL_STREAM_STATE), INTENT(OUT) C: VSLStreamStatePtr*	Copied random stream descriptor

Name

Type

Description

newstream

FORTRAN 77: INTEGER*4 newstream(2)

Fortran 90: TYPE(VSL_STREAM_STATE), INTENT(OUT)

C: VSLStreamStatePtr*

Copied random stream descriptor

Description

The function creates an exact copy of srcstream and stores its descriptor to newstream.

Return Values

VSL_ERROR_OK, VSL_STATUS_OK: Indicates no error, execution is successful.
VSL_ERROR_NULL_PTR: srcstream parameter is a NULL pointer.
VSL_RNG_ERROR_BAD_STREAM: srcstream is not a valid random stream.
VSL_ERROR_MEM_FAILURE: System cannot allocate memory for newstream.