I$WritLn

From NitrOS-9
Jump to: navigation, search
Write Line Writes to a file or device until it encounters a carriage return
OS9 I$WritLn 103F 8C

Entry Conditions

A path number

X address of the data to write

Y maximum number of bytes to write

Exit Conditions

Y number of bytes written

Error Output

CC carry set on error

B error code, if any

Additional Information

  • Writes to the file or device that is associated with the path number specified.
  • Write Line is similar to Write. The difference is that Write Line writes data until it encounters a carriage return character. It also activates line editing for character-oriented devices, such as terminals and printers. The line editing refers to auto line feed, null padding at the end of the line, backspacing, line deleting, and so on.
  • Before using Write Line, be sure the path opened or created in the write or update access mode.
  • For more information about line editing, see “SCF Line Editing Functions” in Chapter 6.