Intel® C++ Compiler Classic Developer Guide and Reference

ID 767249
Date 7/13/2023
Public
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