$A2E: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
m (misc formatting and links)
 
(8 intermediate revisions by 2 users not shown)
Line 2: Line 2:
<span class="pageSubtitle">Translate ASCII to EBCDIC</span>
<span class="pageSubtitle">Translate ASCII to EBCDIC</span>


<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $A2E function is the [[AsciiToEbcdic (String function)]].</p>
<p class="warn"><b>Note:</b> Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the <var>$A2E</var> function is the [[AsciiToEbcdic (String function)]].</p>


The <var>$A2E</var> function returns a string which is the EBCDIC equivalent of the (presumed) ASCII input string. <var>$A2E</var> is longstring capable, that is, it can receive an input longstring and will produce an output longstring.  
The <var>$A2E</var> function returns a string that is the EBCDIC equivalent of the (presumed) ASCII input string. <var>$A2E</var> is [[Longstrings|Longstring]] capable, that is, it can receive an input Longstring and will produce an output Longstring.  


<var>$A2E</var> accepts one required argument and returns a string value.
==Syntax==
 
<p class="syntax"><span class="term">%ebcdic</span> = <span class="literal">$A2E</span>(<span class="term">ascii_val</span>) </p>
The first argument is the string to be translated from ASCII to EBCDIC.


The returned result is a string which is the EBCDIC equivalent of the (presumed) ASCII input string.
<table>
==Syntax==
<tr><th>%ebcdic</th>  
<p class="syntax"><span class="term">%ebcdic</span> = <span class="literal">$A2E</span>(<span class="term">ascii_val</span>)
<td>A string that is the ASCII-to-EBCDIC translation of <var class="term">ascii_val</var>. </td></tr>
</p>


<p><var class="term">%ebcdic</var> is set to the ASCII-to-EBCDIC translation of <var class="term">ascii_val</var>.</p>
<tr><th>ascii_val</th>
<td>The string to be translated from ASCII to EBCDIC. </td></tr>
</table>


==Usage notes==
==Usage notes==
The inverse of <var>$A2E</var> is [[$E2A]].  
<ul>
<li>The inverse of <var>$A2E</var> is <var>[[$E2A]]</var>. </li>


$A2E uses the "standard" ASCII-to-EBCDIC translation tables provided by Sirius, and it provides no mechanism for overriding these tables.
<li><var>$A2E</var> uses the Janus "STANDARD" ASCII-to-EBCDIC translation tables, and it provides no mechanism for overriding these tables. However, as described in [[Translate tables|translation tables]], you are able to modify the STANDARD tables if necessary. </li>
 
<li>The <var>[[$Ebcdic]]</var> function provides the same type of translation as <var>$A2E</var>, but it is only available if the FUNU module is linked in, it does not use the Janus translation tables, and it is <em>not</em> Longstring capable. </li>
</ul>


==Products authorizing {{PAGENAMEE}}==  
==Products authorizing {{PAGENAMEE}}==  
Line 26: Line 30:
<li>[[List of $functions|Sirius functions]]</li>
<li>[[List of $functions|Sirius functions]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[http://m204wiki.rocketsoftware.com/images/4/4a/JoclrNew.pdf Janus Open Client]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]]</li>
<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>
<li>[[Media:JosrvrNew.pdf|Janus Open Server]]</li>
<li>[[Janus Sockets]]</li>
<li>[[Janus Sockets]]</li>
<li>[[Janus Web Server]]</li>
<li>[[Janus Web Server]]</li>
<li>Japanese functions</li>
<li>Japanese functions</li>
<li>[http://m204wiki.rocketsoftware.com/images/4/4b/SirfieldNew.pdf Sir2000 Field Migration Facility]</li>
<li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li>
 
</ul>
</ul>
<p class="caption">Products authorizing $A2E
</p>


[[Category:$Functions|$A2E]]
[[Category:$Functions|$A2E]]

Latest revision as of 22:07, 9 January 2018

Translate ASCII to EBCDIC

Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $A2E function is the AsciiToEbcdic (String function).

The $A2E function returns a string that is the EBCDIC equivalent of the (presumed) ASCII input string. $A2E is Longstring capable, that is, it can receive an input Longstring and will produce an output Longstring.

Syntax

%ebcdic = $A2E(ascii_val)

%ebcdic A string that is the ASCII-to-EBCDIC translation of ascii_val.
ascii_val The string to be translated from ASCII to EBCDIC.

Usage notes

  • The inverse of $A2E is $E2A.
  • $A2E uses the Janus "STANDARD" ASCII-to-EBCDIC translation tables, and it provides no mechanism for overriding these tables. However, as described in translation tables, you are able to modify the STANDARD tables if necessary.
  • The $Ebcdic function provides the same type of translation as $A2E, but it is only available if the FUNU module is linked in, it does not use the Janus translation tables, and it is not Longstring capable.

Products authorizing $A2E