PokeS

PokeS()

Синтаксис

Result = PokeS(*MemoryBuffer , Text$ [, Length [, Flags]])

Описание

Записывает строку в память по указанному адресу, завершая её нулевым символом (#Null).

Параметры

*MemoryBuffer Адрес в памяти для записи.

Text$ Строка, которую требуется записать.

Length (дополн.) Максимальное количество символов, которое может быть записано. Если этот параметр не указан или используется значение -1, то будет записана вся строка. Завершающий нулевой символ, который всегда записывается (если не установлен флаг #PB_String_NoZero ) не включается в этот счет.
Flags (дополн.)
Строковый формат используемый для записи строки. Этот параметр может быть одним из следующих значений:
  #PB_Ascii  : Записывает строки в ascii.
  #PB_UTF8   : Записывает строки в UTF8.
  #PB_Unicode: Записывает строки в unicode (по умолчанию). 
В сочетании с одним из следующих значений:
  #PB_String_NoZero: Не записывает завершающий нуль-символ (#Null).

Возвращаемое значение

Количество байтов, записанных в память, не включая завершающий нулевой символ. Количество записанных байтов будет отличаться от длины строки в символах, если формат - #PB_UTF8 или #PB_Unicode.

Пример (Фран)

*MemoireID = AllocateMemory(5000)
If *MemoireID
PokeS(*MemoireID, "PureBasic hй") ; Записываем значение в область памяти")
Debug PeekS(*MemoireID) ; Считываем значение из области памяти")
FreeMemory(*MemoireID)
Else
Debug "Не удалось выделить требуемую память!"
EndIf

См. также

PeekS(), CopyMemoryString()

Поддерживаемые OS

Все

<- PokeQ() - Оглавление Memory - PokeU()->

*MemoryBuffer	Адрес в памяти для записи.
Text$	Строка, которую требуется записать.
Length (дополн.)	Максимальное количество символов, которое может быть записано. Если этот параметр не указан или используется значение -1, то будет записана вся строка. Завершающий нулевой символ, который всегда записывается (если не установлен флаг #PB_String_NoZero ) не включается в этот счет.
Flags (дополн.)	Строковый формат используемый для записи строки. Этот параметр может быть одним из следующих значений: #PB_Ascii : Записывает строки в ascii. #PB_UTF8 : Записывает строки в UTF8. #PB_Unicode: Записывает строки в unicode (по умолчанию). В сочетании с одним из следующих значений: #PB_String_NoZero: Не записывает завершающий нуль-символ (#Null).