Description: Subroutine for writing a scalar character
or String
to an external text file.
For substring
a scalar of type character
or String
:
call echo(substring, file [, append, terminator, stat, errmsg])
file
is of type character(len=*)
append
is optional
and of type logical
terminator
is optional
and of type character(len=*)
stat
is optional
and of type integer
errmsg
is optional
and of type character(len=*)
For substring
a scalar variable of type String
:
call substring%echo(file [, append, terminator, stat, errmsg])
file
is of type character(len=*)
append
is optional
and of type logical
terminator
is optional
and of type character(len=*)
stat
is optional
and of type integer
errmsg
is optional
and of type character(len=*)
Note
The type-bound procedure access of the form
call substring%echo()
is valid when substring
is a String
variable. To echo a String
-valued expression, the expression must be
passed to echo
by the form call echo()
.
Note
file
may be a relative path, but absolute paths are not
guaranteed to work on every platform.
Append (default is .true.
): append
specifies whether to append or
to replace the file file
. Either way, the file will be created if it
does not exist.
Terminator (default is LF
): terminator
is a string terminator
inserted at the end of the input string.