NAME

sqlite3_randomness — pseudo-Random number generator

SYNOPSIS

#include <sqlite3.h>

void
sqlite3_randomness(int N, void *P);

DESCRIPTION

SQLite contains a high-quality pseudo-random number generator (PRNG) used to select random ROWIDs when inserting new records into a table that already uses the largest possible ROWID. The PRNG is also used for the built-in random() and randomblob() SQL functions. This interface allows applications to access the same PRNG for other purposes.

A call to this routine stores N bytes of randomness into buffer P. The P parameter can be a NULL pointer.

If this routine has not been previously called or if the previous call had N less than one or a NULL pointer for P, then the PRNG is seeded using randomness obtained from the xRandomness method of the default sqlite3_vfs object. If the previous call to this routine had an N of 1 or more and a non-NULL P then the pseudo-randomness is generated internally and without recourse to the sqlite3_vfs xRandomness method.

IMPLEMENTATION NOTES

These declarations were extracted from the interface documentation at line 3101.

SQLITE_API void sqlite3_randomness(int N, void *P);

SEE ALSO

sqlite3_vfs(3)