StrGet() [AHK_L 46+]

Copies a string from a memory address, optionally converting it from a given code page.

String := StrGet(Source , Length , Encoding := None)



The memory address of the string.

The string is not required to be null-terminated if the Length parameter is specified.


The length of the string, in characters. This can be omitted if the string is null-terminated.

Note: Omitting Length when the string is not null-terminated may cause an access violation which terminates the program, or some other undesired result. Specifying an incorrect length may produce unexpected behaviour.

Note: Embedded null characters are unsupported and will generally cause truncation of the string.


The source encoding; for example, "UTF-8", "UTF-16" or "CP936". For numeric identifiers, the prefix "CP" can be omitted only if Length is specified. Specify an empty string or "CP0" to use the system default ANSI code page.

Return Value

This function returns the copied or converted string. If the source encoding was specified correctly, the return value always uses the native encoding. It is always null-terminated, but the null-terminator is not included in the return value's length.

Error Handling

An empty string is returned if invalid parameters are detected, or if the conversion cannot be performed.


Note that the return value is always in the native encoding of the current executable, whereas Encoding specifies how to interpret the string read from the given Source. If no Encoding is specified, the string is simply copied without any conversion taking place.

In other words, StrGet is used to retrieve text from a memory address, or convert it to a format the script can understand.

If conversion between code pages is necessary, the length of the return value may differ from the length of the source string.


String Encoding, StrPut(), Script Compatibility, FileEncoding, DllCall(), VarSetCapacity()


#1: Either Length or Encoding may be specified directly after Source, but in those cases Encoding must be non-numeric:

str := StrGet(address, "cp0")  ; Code page 0, unspecified length
str := StrGet(address, n, 0)   ; Maximum n chars, code page 0
str := StrGet(address, 0)      ; Maximum 0 chars (always blank)