Convert Character String to 64-Bit Integer (CEE4JSTN) API

The Convert Character String to 64-Bit Integer (CEE4JSTN) API converts a character string representation of an integer to its 64-bit integer equivalent.

Authorities and Locks

None.

Required Parameter Group

input_string (input)

A character string representing the integer that needs to be formatted. The valid range for signed integer is (-2⁶³) < x < (2⁶³ - 1). The range for unsigned is (0 < x < 2⁶⁴ - 1).

The following rules apply to input_string.

The decimal separator is retrieved from the job attributes. The input string is scanned left to right until the decimal point or end of string is reached. Any character to the right of the decimal point will be ignored.

Multiple - and + are allowed. The first sign, starting from right to left will indicate the sign of the input.

Imbedded spaces, "-", "+", "." and "," are valid characters.

For examples of this process, see Examples.

length (input)

A 32-bit binary integer representing the number of characters in the input string provided including the sign.

output_integer (output)

A 64-bit storage in which the result is stored.

Omissible Parameter

fc (output)

A 12-byte feedback code passed by reference. If specified as an argument, feedback information (a condition token) is returned to the calling procedure. If not specified, and the requested operation was not successfully completed, the condition is signaled to the condition manager.

Feedback Codes and Conditions

Examples

In the following examples, "." is the decimal separator.

[ Back to top | ILE CEE APIs | APIs by category ]