OD Goto in context

version 1.5

OD Goto in context (context_ID; rowNumber{; index}) Integer

Parameter	Type		Description
context_ID	Longint		Context identifier
rowNumber	Longint		Number of the row in context
index	Integer		Index array
Function result	Integer		Error code
			1 = the operation is successful
			0 = the rowNumber does not exist
			-1 = an error occured

The OD Goto in context function loads the rowNumber row. The rowNumber row becomes the current row.

context_ID must be a previously created and active context identifier.

If rowNumber is greater than the number of rows in the context or smaller than 1, OD Goto in context does not do anything and returns 0.

OD Goto in Context updates 4th Dimension objects with the new current row. For binds involving fields, current records are updated but not saved. If a current record does not exist, OD Goto in context ignores the bind.

index applies only to binds involving arrays. If index is not specified, OD Goto in context adds a line to each array if the new current row has not been loaded. If it has been loaded, OD Goto in context updates the array lines that have the new current row number.

If index is specified, OD Goto in context updates the Index line of each array. If index is beyond the limits of an array, OD Goto in context adds a new line to the array.

OD Goto in context returns 1 if it succeeds, 0 if the RowNumber does not exist, and -1 if an error occurs.

OD Number in context, OD Records in context.