# std::shuffle_order_engine<Engine,K>::discard

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

Advances the internal state by z times. Equivalent to calling operator() z times and discarding the result. The state of the underlying engine may be advanced by more than z times.

## Official Specification Summary (cppreference)

```cpp
void discard( unsigned long long z ); // (since C++11)
```

Advances the internal state by `z` times. Equivalent to calling `operator()` `z` times and discarding the result. The state of the underlying engine may be advanced by more than `z` times.

### Parameters

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

### Return value

(none)

### Exceptions

Throws nothing.

### See also

- [`operator()`](https://en.cppreference.com/w/cpp/numeric/random/shuffle_order_engine/operator()) (C++11): advances the state of the underlying engine and returns the generated value (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/numeric/random/shuffle_order_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.