g05tl generates a vector of pseudorandom integers uniformly distributed over the interval a,b.

Syntax

C#
public static void g05tl(
	int n,
	int a,
	int b,
	G05..::..G05State g05state,
	int[] x,
	out int ifail
)
Visual Basic
Public Shared Sub g05tl ( _
	n As Integer, _
	a As Integer, _
	b As Integer, _
	g05state As G05..::..G05State, _
	x As Integer(), _
	<OutAttribute> ByRef ifail As Integer _
)
Visual C++
public:
static void g05tl(
	int n, 
	int a, 
	int b, 
	G05..::..G05State^ g05state, 
	array<int>^ x, 
	[OutAttribute] int% ifail
)
F#
static member g05tl : 
        n : int * 
        a : int * 
        b : int * 
        g05state : G05..::..G05State * 
        x : int[] * 
        ifail : int byref -> unit

Parameters

n
Type: System..::..Int32
On entry: n, the number of pseudorandom numbers to be generated.
Constraint: n≥0.
a
Type: System..::..Int32
On entry: the end points a and b of the uniform distribution.
Constraint: a≤b.
b
Type: System..::..Int32
On entry: the end points a and b of the uniform distribution.
Constraint: a≤b.
g05state
Type: NagLibrary..::..G05..::..G05State
An Object of type G05.G05State.
x
Type: array<System..::..Int32>[]()[][]
An array of size [n]
On exit: the n pseudorandom numbers from the specified uniform distribution.
ifail
Type: System..::..Int32%
On exit: ifail=0 unless the method detects an error or a warning has been flagged (see [Error Indicators and Warnings]).

Description

g05tl generates the next n values yi from a uniform 0,1 generator (see g05sa for details) and applies the transformation
xi=a+b-a+1yi,
where z is the integer part of the real value z. The method ensures that the values xi lie in the closed interval a,b.
One of the initialization methods (G05KFF not in this release) (for a repeatable sequence if computed sequentially) or (G05KGF not in this release) (for a non-repeatable sequence) must be called prior to the first call to g05tl.

References

Knuth D E (1981) The Art of Computer Programming (Volume 2) (2nd Edition) Addison–Wesley

Error Indicators and Warnings

Errors or warnings detected by the method:
ifail=1
On entry, n<0.
ifail=3
On entry, b<a.
ifail=4
On entry,state vector was not initialized or has been corrupted.
ifail=-9000
An error occured, see message report.
ifail=-8000
Negative dimension for array value
ifail=-6000
Invalid Parameters value

Accuracy

Not applicable.

Parallelism and Performance

None.

Further Comments

None.

Example

See Also