<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">

<html>

<!--(==============================================================)-->
<!--(Document created with RoboEditor. )============================-->
<!--(==============================================================)-->

<head>

<title>Format</title>

<!--(Meta)==========================================================-->

<meta name=generator content="RoboHELP by eHelp Corporation - www.ehelp.com">
<meta name=generator-major-version content=0.1>
<meta name=generator-minor-version content=1>
<meta name=filetype content=kadov>
<meta name=filetype-version content=1>
<meta name=page-count content=1>
<meta name=layout-height content=828>
<meta name=layout-width content=623>
<meta name=date content="01 7, 2003 2:31:38 PM">


<!--(Links)=========================================================-->

<link rel="StyleSheet" href="../../css/main_styles.css">



</head>

<!--(Body)==========================================================-->


<body class="bodydocs" onLoad="top.pageLoader()" bgcolor="#FFFFFF">


<p class=EndLine>&nbsp;</p>

<h1>Format</h1>

<h5 style="margin-left: 40px;"><span style="font-style: italic;">Element 
 Name</span></h5>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">FORMAT </span><span 
 style="font-style: italic;"><span style="font-weight: bold;">name &lt;C_Format_String 
 {\switch}* | non_C_format_string&gt;</span></span></p>

<h5 style="margin-left: 40px;"><span style="font-style: italic;">Description</span></h5>

<p CLASS=ListBulletTxt>The C_format_string is formated as follows:</p>

<p CLASS=ListBulletTxt>Instructs Post to assign the <span style="font-weight: bold;"><span 
 style="font-style: italic;">C_Format_String</span></span> to the format 
 named <span style="font-weight: bold;"><span style="font-style: italic;">name</span></span>. 
 This name (and its format) can be assigned to an Address and will be used 
 by Post to format the output of that Address. If the <span style="font-weight: bold;"><span 
 style="font-style: italic;">C_Format_String</span></span> contains an 
 <span style="font-weight: bold;"><span style="font-style: italic;">s</span></span> 
 the value of the Address is treated as a string; if it contains a <span 
 style="font-weight: bold;"><span style="font-style: italic;">d</span></span> 
 the value is treated as an integer; if it contains a <span style="font-weight: bold;"><span 
 style="font-style: italic;">f </span></span>or <span style="font-weight: bold;"><span 
 style="font-style: italic;">g</span></span> the value is treated as a 
 double. For a complete definition of the format of a <span style="font-weight: bold;"><span 
 style="font-style: italic;">C_Format_String</span></span> see a recent 
 C language book, e.g., <span style="font-style: italic;">C A Reference 
 Manual</span>, by Harbison, S.P. and Steele, G.L. Jr., Prentice Hall, 
 N.J.</p>

<p CLASS=ListBulletTxt>The non_C_format_string is formated as follows:</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">FORMAT &lt;name&gt; &amp;abcdef</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">where:</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">a = + or _</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">+ means to output a '+' as the first character 
 if the number is greater than zero.</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">_ means do not output as a '+'.</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">b = 0 or _</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">0 means to zero-fill the integer output 
 to a length of 'c'.</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">_ means do not output to a length of 'c'..</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">c = {0, 1, 2, ..., 9}</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">The maximum number of integer positions 
 to output. If the value to output exceeds this limit, it is output and 
 an ERROR is raised. If zero-fill is specified (position b) then zeros 
 are left filled to length 'c'.</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">d = . or _</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">If '.' then output a decimal point otherwise 
 don't.</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">e = {0,1,2, ..., 9}</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">The maximum number of fractional (to the 
 right of the decimal point) positions to output. If the digit immediately 
 to the right of the e digit is 5 or more then 1 is added to the e digit.</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">f = 0 or _</p>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">0 means to zero fill the fractional output 
 to a length of 'e'. Exception: if 'e' is greater than 0 (i.e., a real 
 format) and the value of the number to be output is zero then 0.0 is output 
 regardless of the specified format.</p>

<h5 style="margin-left: 40px;"><span style="font-style: italic;">Example</span></h5>

<p CLASS=ListBulletTxt
	style="margin-left: 80px;">FORMAT Socket_2 &quot;%02d&quot;</p>

<p CLASS=EndLine>&nbsp;</p>

<p CLASS=blank>&nbsp;</p>

</body>

</html>
