Let's make the distinction between the offer of built-in functions and library predicates clear:
1) Built-in functions
Obtaining a pseudo-random float using the (built-in) function `random_float∕0`, which generates IEEE 64-bit floats x from 0.0 < x < 1.0 (both boundaries exclusive)
?- X is random_float(). X = 0.9494465703010132.
or without the 0-argument parentheses:
?- X is random_float. X = 0.8947004522094781.
Obtaining a pseudo-random integer using the (built-in) function `random∕1` (i.e. the one on this page):
?- X is random(0xFFFF). X = 48881.
2) Library predicates
This actually just calls random_float∕0 under the hood (inspect the source code from the page of random/1)
?- random(X). X = 0.03479878770414104.
?- random_between(5,100,X). X = 46.
Both boundaries are integer and inclusive.
maybe/0 etc. (predicates)
?- (maybe -> write("heads"); write("tails")).
There is random_member/2, nice for raffles:
?- random_member(X,[1,2,3,4,5,6]). X = 2.
There is also the deprecated random/3 which works for both integers and floats, with the upper boundary exclusive but the lower inclusive in both cases:
?- random(5,100,X),random(0.5,0.8,Y). X = 92, Y = 0.5810354805679784.
As said, for better (but still pseudo-random) numbers, use crypto_n_random_bytes/2
?- crypto_n_random_bytes(5,Bytes). Bytes = [222, 115, 198, 244, 228].
The appropriate OpenSSL man page for that would be (I think), "man RAND_bytes":
Still need more bytes?
On Unix you may also directly get your bytes from the files /dev/random (blocks waiting for randomness from system activity) and /dev/urandom (does not block but emits pseudo-random bytes if there is not enough randomness from system activity, however that is measured)
Extreme alternative & programming fun: Use the HTTP connector to get your random bytes from Internet paid services such as https://api.random.org/json-rpc/2
"Algorithmic Randomness" (Rod Downey & Denis R. Hirschfeldt, 2018):
Generating random atoms
I need these for testing.
Although it uses the random/1 predicate instead of the function, I will just leave it here:
?- random_text(Text,10,[what_text(string)]). Text = "moxnjhkujz". ?- random_text(Text,10,[what_text(atom)]). Text = wshfeotfgr.
Documentation convention needs help!
Although the name of this entry is (as given by the URL)
and the header says "Function random_float∕0", the name of the function is not recognized.
No URL is automatically inserted and the entry is rendered in red:
(Moreover, the subheading says just "random_float".)
How to specify and distinguish the case predicate and (arithmetic) function?
A new convention?
Someone should maybe define a notational convention for functions (as opposed to predicates, which are named by name/arity "functors" or "predicate indicators"), as the ISO standard has omitted to take responsibility on that. Something like
random_float∕∕∕0 (three slashes indicate "function" of the given arity)
random_float∕>0 (a function dataflows in a clear direction, which is suggested by the
To not make the pldoc generator create an URL automatically from a "predicate indicator" as done above in some places: Instead of the slash =/= use the similar-looking math glyph =∕=, Unicode 0x2215. See https://en.wikipedia.org/wiki/Mathematical_operators_and_symbols_in_Unicode:
- random/0 - Uses slash
- random∕0 - Uses 0x2215, just copy and paste it into the slash's position