blob: d5da4aea5476c7b45f4f81fff0978cf4c1d577e4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
|
'\" t
.\" Copyright (c) 2025 Bruce Hill
.\" All rights reserved.
.\"
.TH Path.write_unique_bytes 3 2025-04-19T14:48:15.716011 "Tomo man-pages"
.SH NAME
Path.write_unique_bytes \- Writes the given bytes 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 LIBRARY
Tomo Standard Library
.SH SYNOPSIS
.nf
.BI Path.write_unique_bytes\ :\ func(path:\ Path,\ bytes:\ [Byte]\ ->\ Path)
.fi
.SH DESCRIPTION
Writes the given bytes 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.
.TS
allbox;
lb lb lbx lb
l l l l.
Name Type Description Default
path Path The base path for generating the unique file. This path must include the string `XXXXXX` in the file base name. -
bytes [Byte] The bytes 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_bytes([1, 2, 3])
= (./file-27QHtq.txt)
>> created.read()
= [1, 2, 3]
created.remove()
.EE
|
