write
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | write [2006/08/29 16:08] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | # $EPIC: write.txt,v 1.2 2006/08/20 18:32:13 sthalik Exp $ | ||
+ | ======Synopsis: | ||
+ | $__write__(< | ||
+ | $__writeb__(< | ||
+ | |||
+ | ======Technical: | ||
+ | This function writes the given text to the given file descriptor. | ||
+ | newline is automatically appended to the text. The $__writeb__() variant | ||
+ | does the same thing, except the newline is not automatically appended. | ||
+ | |||
+ | As a special case, a window refnum can be given as the file descriptor | ||
+ | by prefixing the refnum with a w. This provides access to the logfile | ||
+ | for that window. The reserved window refnum 0 can be used to address | ||
+ | the current window' | ||
+ | addresses the global logfile. | ||
+ | |||
+ | ======Practical: | ||
+ | This function is useful for saving information to an external file. It | ||
+ | is most often used in scripts for saving configuration settings and the | ||
+ | like. The $__writeb__() function is useful for writing to binary files, or | ||
+ | for writing lines to a file incrementally. | ||
+ | |||
+ | ======Returns: | ||
+ | < | ||
+ | -1 if file descriptor does not exist | ||
+ | > -1 | ||
+ | </ | ||
+ | |||
+ | ======Examples: | ||
+ | < | ||
+ | $write(7 blah blah) | ||
+ | $write(foo bar) " | ||
+ | $writeb(7 blah blah) writes "blah blah" to fd " | ||
+ | $writeb(foo bar) " | ||
+ | $write(w1 this is a test) write to window refnum 1's logfile | ||
+ | $write(w0 this is a test) write to the current window' | ||
+ | $write(w-1 this is a test) write to the global logfile | ||
+ | </ | ||
write.txt · Last modified: 2006/08/29 16:08 by 127.0.0.1