Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Books 1-3 - <b>printfile()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 PRINTFILE()
 Prints out ASCII files; clears high bits
------------------------------------------------------------------------------
 Syntax

     PRINTFILE(<cFile>, [<lIgnoreHighBit>]) --> lSuccess

 Arguments

     <cFile> Designates the file name to print.

     <lIgnoreHighBit>  When designated as .T., the high bits are not
     cleared.  The default is clears high bits (.F.).

 Returns

     The returned value specifies if a file is successfully printed.  A .T.
     corresponds to a successful execution.

 Description

     PRINTFILE() sends the <cFile>ASCII file to the printer while it clears
     each high bit that is set (MSB -- Most Significant Bit) with each
     carriage return and line feed.  This allows files created with
     MEMOWRITE() to print without any special preparation.  If you do not
     want to suppress the high bit (e.g., when printing a character such as
     <130>, designate the second parameter as .T. to turn it off).

 Notes

     .  Due to known name conflicts with other add on libraries (e.g.,
        dGE, use the name FILEPRINT()on an alternate basis.

     .  The settings for SET PRINTER TO and other printer-related
        functions such as  SETPXLAT() are acknowledged.

 Examples

     .  Print the Memofile.txt file:

        PRINTFILE("Memofile.txt")

     .  Use the function name FILEPRINT() on an alternate basis:

        FILEPRINT("Memofile.txt")

     .  Without high-bit suppression:

        FILEPRINT("Memofile.txt", .T.)


See Also: PRINTREADY() SETSHARE() SETPXLAT()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson