Xlate$: Difference between revisions

From BR Wiki
Jump to navigation Jump to search
m (moved XLATE$ to Xlate$ over redirect)
No edit summary
Line 1: Line 1:
The '''Xlate$''' [[internal function]] returns A$ translated using B$ as a translation table. If X is specified, it starts in position X of string A$; otherwise it starts at the first character of A$.
The '''Xlate$''' [[internal function]] returns a string translated using a second string as a translation table. If a position is specified, it starts at that position of the first string; otherwise it starts at the first character.


  Xlate$(A$,B$[,X])
  XLATE$(<string>,<translation string>[,<position>])


====Comments and Examples====
====Comments and Examples====
XLATE$(A$,B$,X)
Whenever [[ASCII]] character [[null]] (CHR$(0)) is found in A$, it is replaced by the first character in B$. ASCII character [[Ctrl-A]] (CHR$(1)) is replaced by the second character in B$. In other words, ASCII character N-1 is replaced by the Nth character of B$. ASCII values greater than [[LEN]](B$)-1 are not changed.
Whenever [[ASCII]] character [[null]] (CHR$(0)) is found in A$, it is replaced by the first character in B$. ASCII character [[Ctrl-A]] (CHR$(1)) is replaced by the second character in B$. In other words, ASCII character N-1 is replaced by the Nth character of B$. ASCII values greater than [[LEN]](B$)-1 are not changed.



Revision as of 03:26, 22 May 2014

The Xlate$ internal function returns a string translated using a second string as a translation table. If a position is specified, it starts at that position of the first string; otherwise it starts at the first character.

XLATE$(<string>,<translation string>[,<position>])

Comments and Examples

XLATE$(A$,B$,X)

Whenever ASCII character null (CHR$(0)) is found in A$, it is replaced by the first character in B$. ASCII character Ctrl-A (CHR$(1)) is replaced by the second character in B$. In other words, ASCII character N-1 is replaced by the Nth character of B$. ASCII values greater than LEN(B$)-1 are not changed.

00100 LET Y$=XLATE$(X$,TABLE$)

In line 100, Y$ will be a translation of X$ using Table$. For example, spaces (ASCII value 32) will be replaced by Table$(33:33), the character in the 33rd position of Table$.

Related Functions

During input or output operations, data can be translated (for example from ASCII to EBCDIC) by using the TRANSLATE= parameter in the OPEN statement.