Generate a random whole number without consuming a rand

rand_i_look  max (number_or_range)

Given a max number, produces a whole number between 0 and the supplied max value exclusively. If max is a range produces an int within the range. With no args returns either 0 or 1.

Does not consume a random value from the stream. Therefore, multiple sequential calls to rand_i_look will all return the same value.

Introduced in v2.11

Examples

# Example 1

print rand_i_look(5)



# will print either 0, 1, 2, 3, or 4 to the output pane



# Example 2

print rand_i_look(5)
print rand_i_look(5)
print rand_i_look(5)
print rand_i(5)
               
               
print rand_i_look(5)



# will print either 0, 1, 2, 3, or 4 to the output pane
# will print the same number again
# will print the same number again
# will still print the same number again
# (this is the number rand_i_look was 'looking ahead' at)
# the number is now consumed
# will print either 0, 1, 2, 3, or 4 to the output pane