OD Load rows context

version 1.5

OD Load rows context (context_ID{; limit}) Integer

Parameter	Type		Description
context_ID	Longint		Context identifier
limit	Longint		Maximum number of rows to load
Function result	Integer		Number of rows loaded or
			-1 if an error occurs

The OD Load rows context function loads all rows defined by the context into the 4th Dimension objects specified in the context binds.

context_ID must be a previously created and active context identifier.

limit allows you to indicate a maximum number of rows to load.

OD Load rows context creates as many 4th Dimension records or array elements as needed. If limit is 1, and if the context includes binds with fields, OD Load rows context creates a record in memory to load the result line but does not save it (the SAVE RECORD command is not called).

When results are loaded into 4th Dimension records, the current selection of records is set to the records created by 4D for Oracle.

OD Load rows context returns the number of rows loaded or -1 if an error occurs.

The OD Load rows context function takes advantage of array processing.

OD Activate context, OD Next in context.