PureBasic

PeekS()

Синтаксис

Text$ = PeekS(*MemoryBuffer [, Length [, Format]])

Описание


Читает строку из памяти по указанному адресу.

Параметры

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

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

Возвращает прочитанную строку.

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

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

См. также

PokeS(), MemoryStringLength(), CompareMemoryString(), CopyMemoryString()

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

Все

<- PeekQ() - Оглавление Memory - PeekU()->