Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


SQLITE3_RANDOMNESS(3)      Library Functions Manual      SQLITE3_RANDOMNESS(3)

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)

NetBSD 10.99                    August 24, 2023                   NetBSD 10.99