summaryrefslogtreecommitdiff
path: root/Docs/src/string.but
blob: b87125b6e0d054e2ef3bbe4bfb0ecbb82adad384 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
\S1{stringinst} String Manipulation Instructions

\S2{StrCpy} StrCpy

\c user_var(destination) str [maxlen] [start_offset]

Sets the user variable $x with str. Note that str can contain other variables, or the user variable being set (concatenating strings this way is possible, etc). If maxlen is specified, the string will be a maximum of maxlen characters (if maxlen is negative, the string will be truncated abs(maxlen) characters from the end). If start_offset is specified, the source is offset by it (if start_offset is negative, it will start abs(start_offset) from the end of the string).

\c StrCpy $0 "a string" # = "a string"
\c StrCpy $0 "a string" 3 # = "a s"
\c StrCpy $0 "a string" -1 # = "a strin"
\c StrCpy $0 "a string" "" 2 # = "string"
\c StrCpy $0 "a string" "" -3 # = "ing"
\c StrCpy $0 "a string" 3 -4 # = "rin"

\S2{StrLen} StrLen

\c user_var(length output) str

Sets user variable $x with the length of str.

\c StrLen $0 "123456" # = 6