writes strings to a file or pipe - Maple Help

Online Help

All Products    Maple    MapleSim

Home : Support : Online Help : Programming : Input and Output : Output : writeline

writeline - writes strings to a file or pipe

Calling Sequence

writeline(file, str ...)




file descriptor or filename



zero or more Maple strings to be printed



The writeline function writes the specified Maple expressions to the specified file, separated by newlines, and followed by a newline.


The writeline function returns a count of the number of characters written.  Due to different character encodings, this number may differ from the number of bytes written to disk.


If file is default, the output is written to the current output stream. This is where other Maple output would currently go.


If file is terminal, the line is written to the top level output stream. The top level output stream is the current output stream that was in effect when Maple was started.


If no strings are given, only a newline is printed.


If the file being written to is a STREAM or RAW file, and it is currently open in READ mode, it will be reopened in WRITE mode with type TEXT at the same offset.


If a filename is given, and that file is not yet open, it is opened in WRITE mode with type TEXT.

Thread Safety


The writeline command is thread safe as of Maple 15.


Parallel calls to file i/o commands on the same file descriptor will be serialized in an arbitrary order.  If you need the commands to execute in a particular order you must use Maple's synchronization tools to enforce this.  See Threads:-Mutex.


For more information on thread safety, see index/threadsafe.


writelinedefault,This is a test,So is this

This is a test
So is this







See Also

file_types, fprintf, IO_errors, readline, readstat, writebytes, writeline

Download Help Document

Was this information helpful?

Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam