@DATABASE PRINTLIB
@Author Conversion program
@NODE OVERVIEW "Overview of PRINTLIB"

                                  @{b}@{u}Overview@{ub}@{uu}


                          An Acid Software Library

                         Converted to AmigaGuide by

                            Red When Excited Ltd

                 Used with the permission of Acid Software



@ENDNODE OVERVIEW

@NODE Print "PRINTLIB"

@{fg shine}Statement: Print@{fg text}
--------------------------------------------------------------------------------
Modes  : 
Syntax : Print Expression[,Expression...]

Print allows you to output either strings or numeric values to the current 
output channel. Commands such as WindowOutput or BitMapOutput may be used to 
alter the current output channel.


@ENDNODE Print

@NODE NPrint "PRINTLIB"

@{fg shine}Statement: NPrint@{fg text}
--------------------------------------------------------------------------------
Modes  : 
Syntax : NPrint Expression[,Expression...]

NPrint allows you to output either strings or numeric values to the current 
output channel. Commands such as WindowOutput or BitMapOutput may be used to 
alter the current output channel.

After all Expressions have been output, NPrint automatically prints a 
newline character.





@ENDNODE NPrint

@NODE Str$ "PRINTLIB"

@{fg shine}Function: Str$@{fg text}
--------------------------------------------------------------------------------
Modes  : 
Syntax : =Str$ (Expression)

This returns a string equivalent of the numeric value Expression. This now 
allows you to perform string operations on this string.

If the Format command has been used to alter numeric output, this will be 
applied to the resultant string.


@ENDNODE Str$

@NODE Format "PRINTLIB"

@{fg shine}Statement: Format@{fg text}
--------------------------------------------------------------------------------
Modes  : 
Syntax : Format FormatString
Character	Format effect

 #	If no digit to print, insert spaces into output
 0	If no digit to print, insert zeros ('0') into output 
 .	Insert decimal point into output
 +	Insert sign of value
 -	Insert sign of value, only if negative
 ,	Insert commas every 3 digits to left of number


Any other characters in FormatString will appear at appropriate positions in 
the output.

Here are some example of FormatStrings and their output:


Format	StringValue	PrintedOutput

"####.00"	5.2	5.20
"0000.00"	5.2	0005.20
"###,###.00"	10240.25	10,240.25
"Total: -#####"	-10.5	Total: -  11


Format affects the operation of the Str$ function.


@ENDNODE Format

@NODE FloatMode "PRINTLIB"

@{fg shine}Statement: FloatMode@{fg text}
--------------------------------------------------------------------------------
Modes  : 
Syntax : FloatMode Mode : -1=standard, 0=guess, 1=exp

FloatMode allows you to control how floating point numbers are output by the 
Print or NPrint commands.

Floating point numbers may be displayed in one of two ways - in exponential 
format, or in standard format. Exponential format displays a floating point 
number as a value multiplied by ten raised to a power. For example, 10240 
expressed exponentially is displayed as '1.024E+4', ie: 1.024 times 10 to 
the power of 4. Standard format simply prints values 'as is'.

A Mode parameter of 1 will cause floating point values to ALWAYS be 
displayed in exponential format. 
A Mode parameter of -1 will cause floating point values to ALWAYS be 
displayed in standard format. 
A Mode parameter of 0 will cause Blitz 2 to take a 'best guess' at the most 
appropriate format to use. This is the default mode for floating point 
output.

Note that if Format has been used to alter numeric output, standard mode 
will always be used to print floating point numbers.


@ENDNODE FloatMode

@NODE UStr$ "PRINTLIB"

@{fg shine}Function: UStr$@{fg text}
--------------------------------------------------------------------------------
Modes  : 
Syntax : =UStr$ (Expression)

This returns a string equivalent of the numeric value Expression. This now 
allows you to perform string operations on this string.

Unlike Str$, UStr$ is not affected by any active Format commands.
@ENDNODE UStr$

@NODE MAIN "PRINTLIB"

.-----------------------------------------------------------------------------.
|                                  @{b}PRINTLIB@{ub}                                   |
`-----------------------------------------------------------------------------'

                             @{"     Overview     " link OVERVIEW}

                               Command Index                                

                                @{" FloatMode  " link FloatMode}
                                @{" Format     " link Format}
                                @{" NPrint     " link NPrint}
                                @{" Print      " link Print}
                                @{" Str$       " link Str$}
                                @{" UStr$      " link UStr$}

@ENDNODE MAIN