# 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

Parent topic: Parallel Computation Support