Writes a string to the screen or to an open file
Supported Platforms: Windows, Mac OS, and Web
Signature
(write-line str [file-desc])
- str
-
Type: String
A textual value.
- file-desc
-
Type: File
A file descriptor for an open file.
Return Values
Type: String
The str, quoted in the normal manner. The quotes are omitted when writing to a file.
Release Information
- AutoCAD R12 and later on Windows
- AutoCAD 2011 and later on Mac OS
Releases:
History
- str argument previously accepted an ASCII text string or character, but now accepts a Unicode text string or character.
- Return value was modified to support Unicode characters and might be different than earlier releases.
- LISPSYS system variable controls which AutoLISP engine is used and the behavior of the function.
- 0 - ASCII character support (legacy behavior)
- 1 or 2 - Unicode character support
Note: After the value of the LISPSYS system variable has been changed, AutoCAD must be restarted for the change to take affect.
AutoCAD 2021
Examples
- Windows
-
Open a file:
(setq f (open "c:\\my documents\\new.tst" "w")) #<file "c:\\my documents\\new.tst">
Use write-line to write a line to the file:
(write-line "To boldly go where nomad has gone before." f) "To boldly go where nomad has gone before."
The line is not physically written until you close the file:
(close f) nil
- Mac OS
-
Open a file:
(setq f (open "/my documents/new.tst" "w")) #<file "/my documents/new.tst">
Use write-line to write a line to the file:
(write-line "To boldly go where nomad has gone before." f) "To boldly go where nomad has gone before."
The line is not physically written until you close the file:
(close f) nil