String: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "\{\{ *Wikipedia *\| *([-a-zA-Z0-9_#':%\/\\]+) *\| *([-a-zA-Z0-9_#':%\/\\ ]+) *\}\}" to "{{Link|https://en.wikipedia.org/wiki/$1|$2}}")
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
A '''string''' is the [[:Category:Data Types|variable type]] that can contain text.
{{TOC|side}}


== Description ==
A '''string''' is a [[:Category:Data Types|variable type]] that contains text. Possible length and characters depend on the game and its version.


A string may consist of any number of ASCII characters and is enclosed by single-quotes (only in ArmA) or double-quotes. In OFP, strings could alternatively also be written enclosed by curled braces, which are reserved for [[Code]] in ArmA.
{{Feature|informative|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.}}


'''Examples (OFP):'''


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


'''Examples (ArmA):'''
{| class="wikitable" style="text-align: center"
!
! {{Name|ofp|short}}
! {{Name|arma1|short}}
! {{Name|arma2|short}}
! {{Name|arma2oa|short}}
! {{Name|tkoh|short}}
! {{Name|arma3|short}} (before v1.56)
! {{Name|arma3|short}} (since v1.56)
|-
! Max length
| 2056
| colspan="5" | No set limit
| 9,999,999 to 10,000,000<br>(same as [[Array]] length)
|-
! Encoding
| {{Link|https://en.wikipedia.org/wiki/ASCII|ASCII}}
| colspan="6" | {{Link|https://en.wikipedia.org/wiki/Unicode|Unicode}}
|-
! {{Link|https://en.wikipedia.org/wiki/Code_page|Code page}}
| product language defined
| colspan="6" | {{Link|https://en.wikipedia.org/wiki/UTF-8|UTF-8}}
|-
! "text"
| colspan="7" | {{Icon|checked}}
|-
! 'text'
| {{Icon|unchecked}}
| colspan="6" | {{Icon|checked}}
|-
! {text}
| {{Icon|checked}}
| colspan="6" | {{Icon|unchecked}}
|}


_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.
== Commands and Functions ==


_string = "my string ""with"" quotes"
* [[:Category:Command Group: Strings|String Scripting Commands]]
_string2 = 'my other string "with" quotes'
* [[:Category:Function Group: Strings|String Functions]]


== Operators ==


The only basic operator to be used on strings is "plus". You can use "plus" to concatenate two strings.
== Single quote limitation ==
 
Other than double quotes ("text"), single quotes ('text') do not seem to support tabs:
<sqf>
_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"
*/
</sqf>
 
<sqf>
_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
*/
</sqf>
 
<small>Example courtesy of {{Link|http://forums.bistudio.com/member.php?81568-Rydygier|Rydygier}}</small>
 


_string = "Hello " + "world"
== Examples ==


== Commands ==
=== Quotes in Quotes ===


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.
<sqf>
private _string = "my string ""with"" quotes";
private _string = 'my string "with" quotes';
private _string = 'my string with quotes';
</sqf>


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


== Limitations ==
<sqf>
// Operation Flashpoint
_string = "Hello there" // works
_string = 'Hello there' // does NOT work
_string = {Hello there} // works
</sqf>


Since '''ArmA''' strings seem not to have any limitation in length.
<sqf>
// since Armed Assault
_string = "Hello there" // works
_string = 'Hello there' // works
_string = {Hello there} // does NOT work
</sqf>


In '''OFP v1.96''', manipulating and using strings above 2056 characters in length may crash the game.
=== Operators ===


[[Category: Data Types]]
<sqf>private _finalString = "Hello" + " " + "there"; // outputs "Hello there" - the + sign concatenates strings</sqf>
The only basic operator to be used on strings is "plus". You can use "plus" to concatenate two strings.


== Encoding ==
=== Conversion ===


In OFP the strings were internally [http://en.wikipedia.org/wiki/ASCII ASCII], and the [http://en.wikipedia.org/wiki/Code_page code page] used was defined by the product language version (by the fonts which were provided with it).
<sqf>
private _value = 42; // this is a Number
hint _value; // error - hint takes a String, not a Number
hint format ["%1", _value]; // ok
hint str _value; // ok - since Armed Assault
</sqf>


Since ArmA all strings are [http://en.wikipedia.org/wiki/Unicode Unicode], with [http://en.wikipedia.org/wiki/UTF-8 UTF-8] encoding used internally.


Note: 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.
[[Category: Data Types]]

Latest revision as of 00:47, 24 February 2023

A string is a variable type that contains text. Possible length and characters depend on the game and its version.

ⓘ
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.


Properties

OFP ArmA Arma 2 Arma 2:OA TKOH Arma 3 (before v1.56) Arma 3 (since v1.56)
Max length 2056 No set limit 9,999,999 to 10,000,000
(same as Array length)
Encoding ASCII Unicode
Code page product language defined UTF-8
"text" Checked
'text' Unchecked Checked
{text} Checked Unchecked


Commands and Functions


Single quote limitation

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 courtesy of Rydygier


Examples

Quotes in Quotes

private _string = "my string ""with"" quotes"; private _string = 'my string "with" quotes'; private _string = 'my string with quotes';

String Formats

// Operation Flashpoint _string = "Hello there" // works _string = 'Hello there' // does NOT work _string = {Hello there} // works

// since Armed Assault _string = "Hello there" // works _string = 'Hello there' // works _string = {Hello there} // does NOT work

Operators

private _finalString = "Hello" + " " + "there"; // outputs "Hello there" - the + sign concatenates strings

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

Conversion

private _value = 42; // this is a Number hint _value; // error - hint takes a String, not a Number hint format ["%1", _value]; // ok hint str _value; // ok - since Armed Assault

Retrieved from "https://community.bistudio.com/wiki?title=String&oldid=338153"