aboutsummaryrefslogtreecommitdiff
path: root/doc/language/cpsc-keyword-writefile.7.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/language/cpsc-keyword-writefile.7.md')
-rw-r--r--doc/language/cpsc-keyword-writefile.7.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/doc/language/cpsc-keyword-writefile.7.md b/doc/language/cpsc-keyword-writefile.7.md
new file mode 100644
index 0000000..a00be5e
--- /dev/null
+++ b/doc/language/cpsc-keyword-writefile.7.md
@@ -0,0 +1,30 @@
+% CPSC-KEYWORD-WRITEFILE(7)
+
+# NAME
+
+cpsc-keyword-writefile - write a line to a text file
+
+# SYNOPSIS
+
+```text
+WRITEFILE filename, expression
+```
+
+# DESCRIPTION
+
+Write one value as text followed by a newline. Open the file FOR WRITE or
+APPEND first. Exactly one data expression is accepted; join strings with
+`&` when needed. Records, classes, and pointers are unsupported as data.
+
+# EXAMPLE
+
+```text
+OPENFILE "notes.txt" FOR APPEND
+WRITEFILE "notes.txt", "Score: " & NUM_TO_STR(10)
+CLOSEFILE "notes.txt"
+```
+
+# SEE ALSO
+
+[cpsc-language-overview(7)](cpsc-language-overview.7.md), [cpsc-keyword-openfile(7)](cpsc-keyword-openfile.7.md), [cpsc-keyword-closefile(7)](cpsc-keyword-closefile.7.md), [cpsc-function-num_to_str(7)](cpsc-function-num_to_str.7.md).
+