PUTHEAP

Материал из GB wiki
Перейти к: навигация, поиск

Изменяет значение хипового поля. Возвращает весь хип с изменениями.

Синтаксис

PUTHEAP (Хип, Имя поля, Значение поля, Имя секции)

Аргументы

Хип
Строка, которая содержит хип (множество строк вида имя_поля=значение).
Имя поля
Строка, являющаяся именем поля, значение которого требуется обновить. Если поле не существует, оно будет добавлено после всех уже существующих полей (если в хипе есть секции, то в последнюю секцию).
Значение поля
Строка, являющаяся значением указанного во втором параметре поля.
Имя секции
Необязательный параметр. Строка, являющаяся именем секции (по аналогии с ini-файлом). Если имя секции указано, то изменится поле именно в этой секции. Если указанная секция не существует, она будет создана и в неё будет добавлено указанное поле с его значением.

Тип результата

Строка.

Примеры

Меняем значение хипового поля @Department:

PutHeap(Partner.Heap, `@Department`, `25`)

Присвоить значение "C:\Temp\" полю "Path" в секции "Log" (хип хранится в переменной :INI):

PutHeap(:INI, `Path`, `C:\Temp\`, `Log`)

функция вернёт например такое значение:

[Log]
Path=C:\Temp\