Add ability to pick random value from array

[nonunknown]

Returns a random value from the target array.

var array: Array[int] = [1, 2, 3, 4]
print(array.pick_random())  # Prints either of the four numbers.

Implements: godotengine/godot-proposals#3454

[kleonc]

Alternative PR: #65077.

[jcostello]

pick_random is an intuitive name, but just to let you know, other language or libraries call a similar method sample

[fire]

Math::rand() is not the only way of getting a random number, by default Godot picks a not so random number generator.

[mhilbrunner]

Approved in #57007, and approved in today's PR meeting :)

[mhilbrunner]

@nonunknown If you can update the docs to insert the new method's docs at the right place alphabetically, instead of the current place so CI passes, we can merge this. You can ping me once you updated it :)

[nonunknown]

@mhilbrunner I have a serious problem with commit squashing, so if I can have support for squashing I can do this now!

[mhilbrunner]

@nonunknown Sure, I can help you on RC or otherwise just squash the commits for you.

[nonunknown]

I've checked #54940 and seems it doesnt interfere on this PR anymore, so this can be approved without worries!

[mhilbrunner]

Thanks! 🎉

[theraot]

May you bring this to 3.x?

[Overvault-64]

Is there any chance PackedStringArray and the others get pick_random() as well?
Don't know if it's intended but they don't inherit it from Array.