# std::linear_congruential_engine<UIntType,a,c,m>::discard

> C++ Atlas: `cppatlas.com/w/cpp/numeric/random/linear_congruential_engine/discard` | Source: https://en.cppreference.com/w/cpp/numeric/random/linear_congruential_engine/discard | Domain: Numerics

Advances the internal state by z times.

## Official Specification Summary (cppreference)

```cpp
void discard( unsigned long long z );
```

Advances the internal state by `z` times.

### Parameters

- `z` - integer value specifying the number of times to advance the state by

### Complexity

No worse than the complexity of `z` consecutive calls to `operator()`.

### Notes

This function can use “fast jump” algorithms which advance the state by many steps (order of millions) without calculating intermediate state transitions can be used instead of naive loops that calls `operator()` `z` times and discarding the result.

### See also

- [`operator()`](https://en.cppreference.com/w/cpp/numeric/random/linear_congruential_engine/operator()): advances the engine's state and returns the generated value (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/numeric/random/linear_congruential_engine/discard (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.