Navigator User Guide

10.5.1
- 10.5.5
- 10.5.4
- 10.5.3
- 10.5.2
- 10.5
- 10.4.1
- 10.4.0 HotFix 1
- 10.4.0

Back Next

Split

Gets the contents of a field from a specified start point for a specified length. You might use this function to get a single field from a group field.

The field to be split must be a similar data type as the target field For example, you cannot use the Split function to copy a field with a character data type to a target field with a numeric data type.

To create a subfield with a datatype of other than CHAR from a CHAR source field, use the Split function in conjunction with the CopyData function, as follows:

Use the Split function on the source field to create a new CHAR field.

Use the CopyData function on the new CHAR field to create a target field with a different datatype, such as a numeric datatype.

Syntax:

result=Split(field,start_byte,length)

The following table describes the parameters:

Parameter	Description	Datatype
`result`	Returns the contents of the field from the specified start byte for the specified length.	Any type
`field`	Field from which to get a subfield.	Any type
`start_byte`	The number of the byte where the subfield begins. Offsets begin at 1.	NUM32
`length`	The number of bytes to get.	NUM32