[#GetStrongRandBytes]
= GetStrongRandBytes
:mrdocs:

Gather entropy from various sources, feed it into the internal PRNG, and generate random data using it.

== Synopsis

Declared in `<random.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
GetStrongRandBytes(std::span<unsigned char> bytes) noexcept;
----

== Description

This function will cause failure whenever the OS RNG fails.

The normal PRNG is never bypassed here, even in test mode.

Thread‐safe.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *bytes*
| The output buffer to fill with strong random data.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#