$A2E: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (misc formatting and links)
 
(27 intermediate revisions by 4 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="warning">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.  
<table>
<tr><th>%ebcdic</th>
<td>A string that is the ASCII-to-EBCDIC translation of <var class="term">ascii_val</var>. </td></tr>


The returned result is a string which is the EBCDIC equivalent of the (presumed) ASCII input string.
<tr><th>ascii_val</th>  
==Syntax==
<td>The string to be translated from ASCII to EBCDIC. </td></tr>
<p class="syntax"><section begin="syntax" />%EBCDIC = $A2E(ascii_val)
</table>
<section end="syntax" /></p>
<p class="caption">$A2E Function
</p>
<p class="caption">%result is set to the ASCII-to-EBCDIC translation of '''ascii_val'''.</p>


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


The inverse of <var>$A2E</var> is [[$E2A]].  
<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>


$A2E uses the "standard" ASCII-to-EBCDIC translation tables provided by Sirius, and it provides no mechanism for overriding these tables.  
<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>


$A2E is available only in <var class="product">[[Sirius Mods]]</var> Version 6.8 and later.
==Products authorizing {{PAGENAMEE}}==
<ul class="smallAndTightList">
<ul class="smallAndTightList">
<li>[[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>[[Janus Open Client]]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]]</li>
<li>[[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>[[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