9.9 BINTOHEX

Note: Built-In Function Rules     Usage Options

Converts the contents of the source field from its binary format to an alphanumeric string consisting of two characters for each byte in the source.

For example, if Source contains AB, Return alphanumeric string will be C1C2 (IBM i) 4142 (Windows)

Arguments

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

w

Req

Source:
Visual LANSA Note: Source field type can be any RDMLX field type with unlimited length.

1

Unlimited

 

 

2

N

Opt

Number of bytes to be converted. See Technical Note below.

1

11

0

0

 

Return Values

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

X

Req

Returned string
Characters will be 0-9, A-F

2

Unlimited

 

 

2

A

Opt

Return code.
OK = action completed.
ER = An error occurred.

2

2

 

 

 

Technical Note

Second Argument

Built-In Function Behaviour

0 (Default)

The value of the first argument (Source) is treated as a NULL terminated string:

The first NULL byte in the source will be the terminator of the string.

If there is no NULL byte in the source, the BIF will process the whole field.

Any trailing BLANK, Carriage Return(CR) or Line Feed(LF) of the string being processed will be truncated.
For example (in Windows): 
If the source value is

0xC1D4D840C1D4E2E8C4F0F220001F01

Then the actual value processed by this BIF will be:

0xC1D4D840C1D4E2E8C4F0F2

because

the input value is only read until the first NULL( 0x00 )

then the trailing BLANK ( 0x20 ) is truncated.

Any negative value

The whole value of the source field will be processed. No truncation will happen.

Positive, not bigger than the current size of the first argument field

The BIF will process only the specified number of bytes from the source field. No truncation will happen to this portion of the source value.

Bigger than the current size of the first argument field

Return ER.
No conversion will happen.