Add functions to generate random numbers in a specified range.
authorDean Rasheed <dean.a.rasheed@gmail.com>
Wed, 27 Mar 2024 10:12:39 +0000 (10:12 +0000)
committerDean Rasheed <dean.a.rasheed@gmail.com>
Wed, 27 Mar 2024 10:12:39 +0000 (10:12 +0000)
commite6341323a8da64b18e9af3e75a4578230702d61c
treef04f8e7fa84af4b569e58c85d2a7d98f65f45303
parent818861eb578663a0d4d8d7dc4e18c96a148b3c75
Add functions to generate random numbers in a specified range.

This adds 3 new variants of the random() function:

    random(min integer, max integer) returns integer
    random(min bigint, max bigint) returns bigint
    random(min numeric, max numeric) returns numeric

Each returns a random number x in the range min <= x <= max.

For the numeric function, the number of digits after the decimal point
is equal to the number of digits that "min" or "max" has after the
decimal point, whichever has more.

The main entry points for these functions are in a new C source file.
The existing random(), random_normal(), and setseed() functions are
moved there too, so that they can all share the same PRNG state, which
is kept private to that file.

Dean Rasheed, reviewed by Jian He, David Zhang, Aleksander Alekseev,
and Tomas Vondra.

Discussion: https://postgr.es/m/CAEZATCV89Vxuq93xQdmc0t-0Y2zeeNQTdsjbmV7dyFBPykbV4Q@mail.gmail.com
13 files changed:
doc/src/sgml/func.sgml
src/backend/utils/adt/Makefile
src/backend/utils/adt/float.c
src/backend/utils/adt/meson.build
src/backend/utils/adt/numeric.c
src/backend/utils/adt/pseudorandomfuncs.c [new file with mode: 0644]
src/common/pg_prng.c
src/include/catalog/catversion.h
src/include/catalog/pg_proc.dat
src/include/common/pg_prng.h
src/include/utils/numeric.h
src/test/regress/expected/random.out
src/test/regress/sql/random.sql