Intel® C++ Compiler Classic Developer Guide and Reference

ID 767249
Date 3/31/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

svrng_skipahead_engine

Re-initialize engine parameters for use of the skip-ahead method

Syntax

svrng_engine_t svrng_skipahead_engine( svrng_engine_t orig_engine, long long nskip )

Input Parameters

orig_engine

Pointer to the engine to be re-initialized using the skip-ahead technique

nskip

Number of skipped elements

Description

Re-initializes engine parameters using the block-splitting ( "skip-ahead" ) method. The function skips a given number of elements in a random stream. This feature is particularly useful in distributing random numbers from original random stream across different computational nodes. If the largest number of random numbers used by a computational node is nskip, then the original random sequence may be split by this function into non-overlapping blocks of nskip size so that each block corresponds to the respective computational node. The number of computational nodes is unlimited.

Status flags set

Name

Description

SVRNG_STATUS_ERROR_NON_SUPPORTED

Memory allocation procedure failure

SVRNG_STATUS_ERROR_BAD_ENGINE

Bad engine (NULL pointer)

SVRNG_STATUS_ERROR_BAD_PARAM2

Bad parameter: nskip

Return Values

Pointer to the same input engine or NULL on error