PUTHEAP — различия между версиями
Материал из GB wiki
Bars (обсуждение | вклад) |
Alexey (обсуждение | вклад) |
||
| (не показана 1 промежуточная версия 1 участника) | |||
| Строка 1: | Строка 1: | ||
{{Функция ГБ | {{Функция ГБ | ||
|Название=PUTHEAP | |Название=PUTHEAP | ||
| − | |Описание=Изменяет значение хипового поля. Возвращает | + | |Описание=Изменяет значение хипового поля. Возвращает весь хип с изменениями. |
| − | |Синтаксис=PUTHEAP ('''Хип''','''Имя поля''','''Значение поля''') | + | |Синтаксис=PUTHEAP ('''Хип''', '''Имя поля''', '''Значение поля''', Имя секции) |
|Аргументы= | |Аргументы= | ||
{{Аргумент | {{Аргумент | ||
| Строка 9: | Строка 9: | ||
}}<br/>{{Аргумент | }}<br/>{{Аргумент | ||
|Название=Имя поля | |Название=Имя поля | ||
| − | |Пояснение=Строка, являющаяся именем поля, значение которого требуется обновить. | + | |Пояснение=Строка, являющаяся именем поля, значение которого требуется обновить. Если поле не существует, оно будет добавлено после всех уже существующих полей (если в хипе есть секции, то в последнюю секцию). |
}}<br/>{{Аргумент | }}<br/>{{Аргумент | ||
|Название=Значение поля | |Название=Значение поля | ||
|Пояснение=Строка, являющаяся значением указанного во втором параметре поля. | |Пояснение=Строка, являющаяся значением указанного во втором параметре поля. | ||
| + | }}<br/>{{Аргумент | ||
| + | |Название=Имя секции | ||
| + | |Пояснение=Необязательный параметр. Строка, являющаяся именем секции (по аналогии с ini-файлом). Если имя секции указано, то изменится поле именно в этой секции. Если указанная секция не существует, она будет создана и в неё будет добавлено указанное поле с его значением. | ||
}} | }} | ||
|Результат=Строка. | |Результат=Строка. | ||
| − | |Пример=PutHeap (Partner.Heap,`@Department`,`25`) | + | |Пример=Меняем значение хипового поля @Department: |
| + | PutHeap(Partner.Heap, `@Department`, `25`) | ||
| + | Присвоить значение "C:\Temp\" полю "Path" в секции "Log" (хип хранится в переменной :INI): | ||
| + | PutHeap(:INI, `Path`, `C:\Temp\`, `Log`) | ||
| + | функция вернёт например такое значение: | ||
| + | [Log] | ||
| + | Path=C:\Temp\ | ||
}} | }} | ||
Текущая версия на 12:55, 1 декабря 2016
Изменяет значение хипового поля. Возвращает весь хип с изменениями.
Синтаксис
PUTHEAP (Хип, Имя поля, Значение поля, Имя секции)
Аргументы
- Хип
- Строка, которая содержит хип (множество строк вида имя_поля=значение).
- Имя поля
- Строка, являющаяся именем поля, значение которого требуется обновить. Если поле не существует, оно будет добавлено после всех уже существующих полей (если в хипе есть секции, то в последнюю секцию).
- Значение поля
- Строка, являющаяся значением указанного во втором параметре поля.
- Имя секции
- Необязательный параметр. Строка, являющаяся именем секции (по аналогии с ini-файлом). Если имя секции указано, то изменится поле именно в этой секции. Если указанная секция не существует, она будет создана и в неё будет добавлено указанное поле с его значением.
Тип результата
- Строка.
Примеры
Меняем значение хипового поля @Department:
PutHeap(Partner.Heap, `@Department`, `25`)
Присвоить значение "C:\Temp\" полю "Path" в секции "Log" (хип хранится в переменной :INI):
PutHeap(:INI, `Path`, `C:\Temp\`, `Log`)
функция вернёт например такое значение:
[Log] Path=C:\Temp\
