SQLITE3_RANDOMNESS(3)

SQLITE3_RANDOMNESS(3) | Library Functions Manual | SQLITE3_RANDOMNESS(3)

# NAME

`sqlite3_randomness` —
Pseudo-Random Number Generator

# SYNOPSIS

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 build-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.

# SEE ALSO

sqlite3_vfs(3)

December 19, 2018 | NetBSD 10.1