Translate (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
(29 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:String:Translate subtitle}}
{{Template:String:Translate subtitle}}


The Translate method takes a string or longstring input and outputs a copy of it in which        
<var>Translate</var> takes a string input and outputs a copy of it in which any of the input characters that are specified in a character mapping object are replaced with the characters to which they are mapped by the object.  <var>Translate</var> takes a <var>[[characterMap_class|CharacterMap]]</var> object as input which maps <var>In</var> ("input table") characters to <var>Out</var> ("output table") characters.
any of the input characters that are specified in a character mapping object                    
 
are replaced with the characters to which they are mapped by the object.                         
                                                                                                 
Translate has many similarities to the Sirius function $LSTR_TRANSLATE, which is described in the '''''Sirius Functions Reference Manual'''''.   
                                                                                                 
The Translate method takes a CharacterMap object as input. A [[aracterMap class|CharacterMap]] object maps In ("input table")  
characters to Out ("output table") characters.      
==Syntax==
==Syntax==
{{Template:String:Translate syntax}}
{{Template:String:Translate syntax}}
===Syntax terms===
===Syntax terms===
<dl>                                                                                            
<table class="syntaxTable">
<dt>%outStr                                                                                     
<tr><th>%outString</th>
<dd>A string or Longstring to receive the translated input string.                              
<td>A string or to receive the translated input <var class="term">string</var>.</td></tr>
<dt>string                                                                                      
<tr><th>string</th>
<dd>The input string or Longstring.                                                              
<td>The method object input string.</td></tr>
<dt>charMap                                                                                     
<tr><th>characterMap</th>
<dd>A CharacterMap object variable which indicates the output characters to which specified input characters are to be mapped.  
<td>A <var>[[characterMap_class|CharacterMap]]</var> object variable which defines the relationship (mapping) between input and output characters.</td></tr>
                                                                                                 
</table>
</dl>                                                                                            
 
==Usage notes==
==Usage notes==
*For information about constructing a CharacterMap object, see [[CharacterMap New constructor]].
<ul>
<li>For information about constructing a <var>CharacterMap</var> object, see <var>[[New_(CharacterMap_constructor)|New]]</var>, the <var>CharacterMap</var> constructor.
</ul>
 
==Examples==
==Examples==
                                                                                                 
In the following request, a's are translated to B's, and c's are translated to d's, as dictated by the character mapping in <code>%map</code>:
In the following request, a's are translated to B's, and c's are translated to d's, as dictated by the character mapping in %map:  
<p class="code">begin
    Begin                                                                                       
  %map is object characterMap
    %map is object characterMap  
  %ls is longstring
    %ls is longstring                                              
                                                                   
    %map = new(in='ac',out='Bd')                                   
    %ls = 'aaaccc'                                                 
    [[Intrinsic classes#printtext|printText]] {~} = '{%ls:translate(%map)}'
    End                                                           
                                                                   
The result is:                                                     
    %ls:translate(%tr) = 'BBBddd'


===See also===                                                    
  %map = new(in='ac',out='Bd')
[[List of intrinsic String methods]]
  %ls = 'aaaccc'
  [[PrintText statement|printText]] {~} = '{%ls:translate(%map)}'
end
</p>
The result is:
<p class="output">%ls:translate(%tr) = 'BBBddd'
</p>


[[Category:Intrinsic String methods|Translate function]]
==See also==
[[Category:Intrinsic methods]]
<ul><li><var>Translate</var> has many similarities to the Sirius function <var>[[$Lstr_Translate]]</var>.</ul>
{{Template:String:Translate footer}}

Latest revision as of 22:42, 5 November 2012

Apply a Character Map to the method object string (String class)


Translate takes a string input and outputs a copy of it in which any of the input characters that are specified in a character mapping object are replaced with the characters to which they are mapped by the object. Translate takes a CharacterMap object as input which maps In ("input table") characters to Out ("output table") characters.

Syntax

%outString = string:Translate( characterMap)

Syntax terms

%outString A string or to receive the translated input string.
string The method object input string.
characterMap A CharacterMap object variable which defines the relationship (mapping) between input and output characters.

Usage notes

  • For information about constructing a CharacterMap object, see New, the CharacterMap constructor.

Examples

In the following request, a's are translated to B's, and c's are translated to d's, as dictated by the character mapping in %map:

begin %map is object characterMap %ls is longstring %map = new(in='ac',out='Bd') %ls = 'aaaccc' printText {~} = '{%ls:translate(%map)}' end

The result is:

%ls:translate(%tr) = 'BBBddd'

See also