22.02.2015 Views

HLASM Language Reference

HLASM Language Reference

HLASM Language Reference

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

| X2B<br />

Output: UPPER('cexpr') or (UPPER 'cexpr') converts the alphabetic<br />

characters a-z in the argument to upper case, A-Z. Null arguments return a<br />

null string.<br />

Examples<br />

UPPER('aBcDefG')<br />

| Format: Function-invocation<br />

| Operands: Character<br />

has value 'ABCDEFG'<br />

| Output: X2B('hexstring') converts the value of its argument string of<br />

| hexadecimal characters to a character string containing only zero ('') and<br />

| one ('1') characters representing the same bit pattern. Null arguments return<br />

| a null string.<br />

| If the result is not too long, the length of the result is four times the length of<br />

| the 'hexstring' argument.<br />

| The operand must contain only hexadecimal digits. Any other value causes<br />

| the message ASMA214E to be generated.<br />

| Examples<br />

| X2B('') has value '' (null string)<br />

| X2B('') has value ''<br />

| X2B('1') has value '1'<br />

| X2B('F3') has value '111111'<br />

| X2B('F3') has value '111111'<br />

| X2C<br />

| Format: Function-invocation<br />

| Operands: Character<br />

| Output: X2C('hexstring') converts the hexstring argument to characters<br />

| representing the same bit pattern. Null arguments return a null string.<br />

| If needed, the argument string is padded internally on the left with a zero<br />

| character so that its length is a multiple of two.<br />

| The operand must contain only hexadecimal digits. Any other value causes<br />

| the message ASMA214E to be generated.<br />

| Examples<br />

| X2C('') has value '' (null string)<br />

| X2C('F3') has value '3'<br />

| X2C('') has value 'n' (EBCDIC null character)<br />

| X2C('F1F2F3F4F5') has value '12345'<br />

| X2C('F1') has value 'nn1'<br />

| X2D<br />

| Format: Function-invocation<br />

| Operands: Character<br />

| Output: X2D('hexstring') converts its argument string of at most eight<br />

| hexadecimal characters to one to ten decimal characters preceded by a plus<br />

| or minus sign, representing the value of the argument. Null arguments return<br />

| '+'. For example:<br />

Chapter 9. How to Write Conditional Assembly Instructions 381

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!