String

Description

A string is the variable type that can contain text and may consist of any number of ASCII characters and is enclosed by single-quotes (only in Armed Assault) or double-quotes. In Operation Flashpoint, strings could alternatively also be written enclosed by curled braces, which are reserved for Code in Armed Assault.

From Arma 3 v1.55.133789 strings are limited to maximum of 9,999,999 (sometimes 10,000,000) characters

Examples Operation Flashpoint

_string = "here is my string"
_string2 = {It may contain a lot of characters #@$}

Examples Armed Assault

_string = "here is my string"
_string2 = 'It may contain a lot of characters #@$'

If you want to include double quotes (") in strings enclosed by double quotes, the inside double quotes have to be written twice.

_string = "my string ""with"" quotes"
_string2 = 'my other string "with" quotes'

Operators

The only basic operator to be used on strings is "plus". You can use "plus" to concatenate two strings.

_string = "Hello " + "world"

Commands

You can convert any type to a string using the command format. You can also use that command to build together a string out of different elements. See the documentation of format for a closer description.

_string = format ["%1", ["my","array","of","strings"]]
hint _string

=> ["my","array","of","strings"]

Limitations

Since Armed Assault strings seem not to have any limitation in length.

In Operation Flashpoint v1.96, manipulating and using strings above 2056 characters in length may crash the game.

Other than double quotes ("text"), single quotes ('text') do not seem to support tabs:

_string = "	
	";
copyToClipboard _string;
diag_log format ["%1 %2 %3 x%4x", toArray _string, toArray copyFromClipboard, toArray (_string select [0]), _string];

/*return is good: "[9,10,9] [9,10,9] [9,10,9] x	
	x"*/

_string = '	
	';
copyToClipboard _string;
diag_log format ["%1 %2 %3 x%4x", toArray _string, toArray copyFromClipboard, toArray (_string select [0]), _string];

/*return: "[9,10] [9,10] [9,10] x	
x" - second tab vanished*/

Example by Rydygier

Encoding

In Operation Flashpoint the strings were internally ASCII, and the code page used was defined by the product language version (by the fonts which were provided with it).

Since Armed Assault all strings are Unicode, with UTF-8 encoding used internally.

ⓘ

The encoding should be mostly transparent. The input files can be encoded both in UTF-16 or UTF-8, the toString and toArray functions always convert from/to UTF-16 representation.