|
|
| (One intermediate revision by one other user not shown) |
| Line 1: |
Line 1: |
| <span style="font-size:120%; color:black"><b><section begin=dpl_desc/>Print the FloatNamedArraylist<section end=dpl_desc/></b></span>
| | #REDIRECT [[Print (GenericNamedArraylist subroutine)]] |
| [[Category:FloatNamedArraylist methods|Print subroutine]]
| |
| <!--DPL?? Category:FloatNamedArraylist methods|Print subroutine: Print the FloatNamedArraylist-->
| |
| <p>
| |
| Print is a member of the [[FloatNamedArraylist class]].
| |
| </p>
| |
| | |
| This subroutine displays the contents of a FloatNamedArraylist on the user's
| |
| standard output device, typically a terminal.
| |
| The list item values, displayed in numeric order by their float subscripts,
| |
| are preceded by their item number and subscript number, both of which by default
| |
| are followed by a colon (<tt>:</tt>) and a blank.
| |
| ==Syntax==
| |
| %fnamrayl:Print( [method] -
| |
| [, NumWidth=itemnumlen] -
| |
| [, Separator=separator] -
| |
| [, NameWidth=itemnamelen] -
| |
| [, Start=firstitem] -
| |
| [, MaxItems=maxitems] -
| |
| [, Label=label] )
| |
| ===Syntax Terms===
| |
| <dl>
| |
| <dt><i>%rc</i>
| |
| <dd>A numeric variable that is set to the number of FloatNamedArraylist items displayed.
| |
| <dt><i>%fnamrayl</i>
| |
| <dd>A FloatNamedArraylist object.
| |
| <dt><i>method</i>
| |
| <dd>The method that is applied to ''%fnamrayl'' items to produce the
| |
| printed output.
| |
| The method must take no parameters and produce an intrinsic (Float,
| |
| String, Fixed, Unicode) value.
| |
| It may be a system or user-written
| |
| method, a class Variable or Property, a local method ([[??]] refid=localm.),
| |
| or a [[Method variables|Method variable]].
| |
| | |
| The default value of ''method'' is <tt>ToString</tt>.
| |
| <dt><b>NumWidth=</b><i> itemnumlen</i>
| |
| <dd>The number of bytes in the display of each item to use for the
| |
| item number (position).
| |
| This is an optional parameter; if you specify a value, the parameter
| |
| name <tt>NumWidth</tt> is required.
| |
| | |
| Item numbers are right-justified within the indicated number of bytes, and they
| |
| are truncated on the left if the length of the item number exceeds the
| |
| space allocated for it.
| |
| The width must be a number between -1 and 10 inclusive.
| |
| If you specify a value of 0, the item number is not displayed.
| |
| | |
| If NumWidth is -1, the default, the method uses the minimum number
| |
| of bytes required to show the item number.
| |
| For example, one byte is required for item number 5, while five bytes
| |
| are required for item number 98764.
| |
| <dt><b>Separator=</b><i> separator</i>
| |
| <dd>A String, 15 characters or less, to be used to separate both the item
| |
| number and the float subscript from what follows.
| |
| That is, the ''separator'' you specify appears twice: once after the
| |
| item number and once after the item subscript.
| |
| | |
| This is an optional argument whose default is a colon (<tt>:</tt>).
| |
| A blank always follows the ''separator'' string.
| |
| If you specify a value, the parameter name <tt>Separator</tt> is required.
| |
| <dt><b>Start=</b><i> firstitem</i>
| |
| <dd>The item number of the initial item in the output display.
| |
| This is an optional argument, and it defaults to 1.
| |
| If you specify a value, the parameter name <tt>Start</tt> is required.
| |
| <dt><b>MaxItems=</b><i> maxitems</i>
| |
| <dd>The maximum number of items to display.
| |
| A zero or negative value means to display all the items.
| |
| | |
| This is an optional argument, and it defaults to zero.
| |
| If you specify a value, the parameter name <tt>MaxItems</tt> is required.
| |
| <dt><b>Label=</b><i> label</i>
| |
| <dd>A literal string that gets output before each line.
| |
| This is useful for “tagging” lines to make them more identifiable.
| |
| | |
| This is an optional argument whose default is a null string.
| |
| If you specify a value, the parameter name <tt>Label</tt> is required.
| |
| <dt><b>NameWidth=</b><i> itemnamelen</i>
| |
| <dd>The number of bytes in the display of the item subscript number.
| |
| This must be a number from -1 through 255.
| |
| If you specify a value, the parameter name <tt>NameWidth</tt> is required.
| |
| | |
| Item subscripts are left-justified within the indicated number of bytes, and they
| |
| are truncated on the right if the length of the item subscript exceeds the
| |
| space allocated for it.
| |
| | |
| If you specify a value of 0, the item subscript is not displayed.
| |
| | |
| This is an optional argument; it defaults to -1, which directs the method to use
| |
| whatever number of bytes are necessary to show the entire item subscript.
| |
| For example, three bytes are required for item subscript <tt>111</tt>.
| |
| | |
| </dl>
| |
| ==Usage Notes==
| |
| <ul>
| |
| <li>All errors in Print result in request cancellation.
| |
| <li>[[Audit (FloatNamedArraylist subroutine)|Audit]] and [[Trace (FloatNamedArraylist subroutine)|Trace]] are
| |
| the same as Print except they send their output to the audit trail
| |
| and selected trace destination, respectively.
| |
| <li>For examples of Print method calls, see [[Collections#Printing a collection|Printing a collection]].
| |
| </ul>
| |