<<

Contents

Search

>>

 

CHANGE_FIELDSEQUENCE

 

 

Function

 

 

Syntax:

CHANGE_FIELDSEQUENCE(<Field Number>,<New Field Number>)

 

<Field Number>

= <NUM-EXPRESSION>

<New Field Number>

= <NUM-EXPRESSION>

 

 

Meaning:

Change of field sequence on the current mask.

 

Field no. 1 <Field Number> contains the new sequence number <New Field Number>. <Field Number> and <New Field Number> refer to the program internal field sequence (Field Numbers ascending in gapless order).

 

The function returns the following values:

 

 0: no error

-2: <Field Number> and <New Field Number> are identical

-3: <Field Number> does not exist

-4: Mask does not contain any fields

-99: Mask not found

 

Parameter:

Field Number

Sequence number which has to be changed

New Field Number

New sequence number

 

Sample:

/* Old sequence: A  B  C  D

H% = CHANGE_FIELDSEQUENCE(1,3)

/* New sequence: B  C  A  D

 

See also:

ADD_FIELD

EBUS_FNR