'\" t
.\" Copyright (c) 2025 Bruce Hill
.\" All rights reserved.
.\"
.TH Text.join 3 2025-09-21 "Tomo man-pages"
.SH NAME
Text.join \- concatenate with separator
.SH LIBRARY
Tomo Standard Library
.SH SYNOPSIS
.nf
.BI Text.join\ :\ func(glue:\ Text,\ pieces:\ [Text]\ ->\ Text)
.fi
.SH DESCRIPTION
Joins a list of text pieces with a specified glue.


.SH ARGUMENTS

.TS
allbox;
lb lb lbx lb
l l l l.
Name	Type	Description	Default
glue	Text	The text used to join the pieces. 	-
pieces	[Text]	The list of text pieces to be joined. 	-
.TE
.SH RETURN
A single `Text` value with the pieces joined by the glue.

.SH EXAMPLES
.EX
assert ", ".join(["one", "two", "three"]) == "one, two, three"
.EE