Andrew Branscom: 2 revisions imported

2025-02-16T21:05:27Z

2 revisions imported

← Older revision	Revision as of 16:05, 16 February 2025
(No difference)

Andrew Branscom: 1 revision imported

2024-06-03T05:14:29Z

1 revision imported

← Older revision	Revision as of 00:14, 3 June 2024
(No difference)

Andrew Branscom: 1 revision imported

2022-01-28T16:19:49Z

1 revision imported

New page

The '''set.string''' command assigns the text of a message to a string.

== Syntax ==

set.string([[string|str]] sA, [[message|msg]] mB);<br />
set.string([[string|str]] sA, "message text");<br />
sA = mB;<br />
sA = "message text";

== Remarks ==

[[String]]s are limited to 40 characters (including the null terminator). If the [[message]] text is longer than 40 characters, the string only uses the first 40. This is one of the few situations where AGI actually checks and prevents buffer overflow.

The number of strings available in AGI is 24 (s0 - s23), except for [[versions]] 2.089, 2.272 and 3.002.149, which have a limit of 12 (s0 - s11).

The very first string (s0) is reserved by AGI as the player [[input prompt]].

== Possible Errors ==

AGI does not check that '''sA''' is a valid string. If a value greater than the limit is used, AGI will write over areas of memory that contains game state data and the main program executable code. This will almost certainly [[crash AGI]].

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
set.string(s5, "a sample message");
s5 = "another sample message";
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 114 (0x72 hex)
|}

== See Also ==

[[String Commands]]<br />
[[Category:Commands]]<br />

Set.string - Revision history

Andrew Branscom: 2 revisions imported

Andrew Branscom: 1 revision imported

Andrew Branscom: 1 revision imported