RandomExtensionsNextUInt64(Random, UInt64, Boolean) Method

Returns a random 64-bit unsigned integer that is within the specified maximum.

Definition

Namespace: KGySoft.CoreLibraries
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 10.0.0

C#

[CLSCompliantAttribute(false)]
public static ulong NextUInt64(
	this Random random,
	ulong maxValue,
	bool inclusiveUpperBound = false
)

VB

<ExtensionAttribute>
<CLSCompliantAttribute(false)>
Public Shared Function NextUInt64 ( 
	random As Random,
	maxValue As ULong,
	Optional inclusiveUpperBound As Boolean = false
) As ULong

C++

public:
[ExtensionAttribute]
[CLSCompliantAttribute(false)]
static unsigned long long NextUInt64(
	Random^ random, 
	unsigned long long maxValue, 
	bool inclusiveUpperBound = false
)

F#

[<ExtensionAttribute>]
[<CLSCompliantAttribute(false)>]
static member NextUInt64 : 
        random : Random * 
        maxValue : uint64 * 
        ?inclusiveUpperBound : bool 
(* Defaults:
        let _inclusiveUpperBound = defaultArg inclusiveUpperBound false
*)
-> uint64

Parameters

random Random: The Random instance to use.
maxValue UInt64: The upper bound of the random number returned.
inclusiveUpperBound Boolean (Optional): to allow that the generated value is equal to maxValue; otherwise, . This parameter is optional.
Default value: .

Return Value

UInt64
A 64-bit unsigned integer that is greater than or equal to 0 and less than or equal to maxValue. If inclusiveUpperBound is , then maxValue is an exclusive upper bound; however, if maxValue equals 0, then 0 is returned.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type Random. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Exceptions

ArgumentNullException

random is .