+

Joins two strings into a new one.

Module: Text

Signature

func +(self, other: String) -> String;
func +(self, other: char8[]) -> String;

Parameters

Name	Type	Description
other	String / char8[]	The bytes to append.

Returns

A new String holding the bytes of both operands, in a block of its own. Both operands are left as they were, and joining two empty strings allocates nothing.

The slice overload lets a literal be joined on without wrapping it in a String first.

The result owns its block and has to be released with Free — including the intermediate results of a chain, which is what makes a + b + c three allocations and two leaks if only the last one is freed. In a loop it is a chain of allocations: accumulate with a StringBuilder instead.

Example

import Text::String;

var greeting = String::From("Hello");
var name = String::From("Rux");

var comma = greeting + ", "; // "Hello, "
var full = comma + name;     // "Hello, Rux"

full.Free();
comma.Free();                // the intermediate owns a block too
name.Free();
greeting.Free();

See also

• String — the string type
• StringBuilder::Append — join without allocating on every step
• Repeat — join a string to itself N times, in one allocation
• Free — release the block the result owns