writeline - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


writeline

writes strings to a file or pipe

 

Calling Sequence

Parameters

Description

Thread Safety

Examples

Calling Sequence

writeline(file, str ...)

Parameters

file

-

file descriptor or filename

str

-

zero or more Maple strings to be printed

Description

• 

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.

Examples

writelinedefault,This is a test,So is this

This is a test
So is this

26

(1)

writelinedefault

 

1

(2)

See Also

file_types

fprintf

IO_errors

readline

readstat

writebytes

writeline