aboutsummaryrefslogtreecommitdiff
path: root/man/man3/tomo-Path.append.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3/tomo-Path.append.3')
-rw-r--r--man/man3/tomo-Path.append.335
1 files changed, 35 insertions, 0 deletions
diff --git a/man/man3/tomo-Path.append.3 b/man/man3/tomo-Path.append.3
new file mode 100644
index 00000000..c008cb66
--- /dev/null
+++ b/man/man3/tomo-Path.append.3
@@ -0,0 +1,35 @@
+'\" t
+.\" Copyright (c) 2025 Bruce Hill
+.\" All rights reserved.
+.\"
+.TH Path.append 3 2025-04-19T14:30:40.364773 "Tomo man-pages"
+.SH NAME
+Path.append \- Appends the given text to the file at the specified path, creating the file if it doesn't already exist. Failure to write will result in a runtime error.
+
+.SH LIBRARY
+Tomo Standard Library
+.SH SYNOPSIS
+.nf
+.BI "Path.append : func(path: Path, text: Text, permissions: Int32 = Int32(0o644) -> Void)"
+.fi
+
+.SH DESCRIPTION
+Appends the given text to the file at the specified path, creating the file if it doesn't already exist. Failure to write will result in a runtime error.
+
+
+.TS
+allbox;
+lb lb lbx lb
+l l l l.
+Name Type Description Default
+path Path The path of the file to append to. -
+text Text The text to append to the file. -
+permissions Int32 The permissions to set on the file if it is being created. Int32(0o644)
+.TE
+.SH RETURN
+Nothing.
+
+.SH EXAMPLES
+.EX
+(./log.txt).append("extra line$(\\n)")
+.EE