'\" t
.\" Copyright (c) 2025 Bruce Hill
.\" All rights reserved.
.\"
.TH Path.write_unique 3 2025-11-29 "Tomo man-pages"
.SH NAME
Path.write_unique \- write to a uniquely named file
.SH LIBRARY
Tomo Standard Library
.SH SYNOPSIS
.nf
.BI Path.write_unique\ :\ func(path:\ Path,\ text:\ Text\ ->\ Path)
.fi
.SH DESCRIPTION
Writes the given text to a unique file path based on the specified path. The file is created if it doesn't exist. This is useful for creating temporary files.


.SH ARGUMENTS

.TS
allbox;
lb lb lbx
l l l.
Name	Type	Description
path	Path	The base path for generating the unique file. This path must include the string \fBXXXXXX\fR in the file base name. 
text	Text	The text to write to the file. 
.TE
.SH RETURN
The path of the newly created unique file.

.SH EXAMPLES
.EX
created := (./file-XXXXXX.txt).write_unique("Hello, world!")
assert created == (./file-27QHtq.txt)
assert created.read() == "Hello, world!"
created.remove()
.EE
.SH SEE ALSO
.BR Tomo-Path (3)