$E2A: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (add links)
 
(22 intermediate revisions by 4 users not shown)
Line 2: Line 2:
<span class="pageSubtitle">Translate EBCDIC to ASCII</span>
<span class="pageSubtitle">Translate EBCDIC to ASCII</span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $E2A function is the [[EbcdicToAscii (String function)]].  For a full list of string and numeric conversion functions see [[List of String methods]] and [[List of Float methods]].</p>
<p class="warn"><b>Note:</b> Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the <var>$E2A</var> function is <var>[[EbcdicToAscii (String function)|EbcdicToAscii]]</var>.  For a full list of string and numeric conversion functions, see [[List of String methods]] and [[List of Float methods]].</p>


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


$E2A accepts one required argument and returns a string value.
The first argument is the string to be translated from EBCDIC to ASCII.
The returned result is a string which is the ASCII equivalent of the (presumed) EBCDIC input string.
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" />%ASCII = $E2A(ebcdic_val)
<p class="syntax"><span class="term">%ascii</span> = <span class="literal">$E2A</span>(<span class="term">ebcdic_val</span>) </p>
<section end="syntax" /></p>
<p>
<p>
</p>
<var class="term">%ascii</var> is a string set to the EBCDIC-to-ASCII translation of <var class="term">ebcdic_val</var>, the EBCDIC string to be translated.</p>
<p>%result is set to the EBCDIC-to-ASCII translation of '''ebcdic_val'''.</p>


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


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


$E2A uses the "standard" EBCDIC-to-ASCII translation tables provided by Sirius, and it provides no mechanism for overriding these tables.  
<li>The <var>[[$Ascii]]</var> function provides the same type of translation as <var>$E2A</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>


$E2A is available only in <var class="product">[[Sirius Mods]]</var> Version 6.8 and later.
==Products authorizing {{PAGENAMEE}}==
<h2>Products authorizing {{PAGENAMEE}}</h2><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>
<p class="caption">Products authorizing $E2A
</p>
 


[[Category:$Functions|$E2A]]
[[Category:$Functions|$E2A]]

Latest revision as of 23:21, 11 January 2018

Translate EBCDIC to ASCII

Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $E2A function is EbcdicToAscii. For a full list of string and numeric conversion functions, see List of String methods and List of Float methods.

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

Syntax

%ascii = $E2A(ebcdic_val)

%ascii is a string set to the EBCDIC-to-ASCII translation of ebcdic_val, the EBCDIC string to be translated.

Usage notes

  • The inverse of $E2A is $A2E.
  • $E2A 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 $Ascii function provides the same type of translation as $E2A, 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 $E2A