http://sfsys.ru/index.php?action=history&feed=atom&title=GlobalStringsHeapsAddGlobalStringsHeapsAdd - Revision history2026-04-04T10:05:33ZRevision history for this page on the wikiMediaWiki 1.31.1http://sfsys.ru/index.php?title=GlobalStringsHeapsAdd&diff=5116&oldid=prevAdmin: 1 revision imported2025-12-27T17:06:04Z<p>1 revision imported</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">Revision as of 17:06, 27 December 2025</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Adminhttp://sfsys.ru/index.php?title=GlobalStringsHeapsAdd&diff=5115&oldid=prev1>Admin at 07:42, 8 November 20252025-11-08T07:42:22Z<p></p>
<p><b>New page</b></p><div>{{infobox function<br />
|name=GlobalStringsHeapsAdd<br />
|object=[[Функции общего назначения]]<br />
|caption=Глобальные строки-массивы<br />
|type=1<br />
|status=2<br />
|db=0<br />
|exception=Неверные агрументы, системная ошибка сервера<br />
|visual=0}}<br />
{{HeadLinks|<br />
* [[Main_Page|Начальная страница]]<br />
* [[Общее_описание_языка|Общее описание]]<br />
* [[Объекты]]<br />
* [[Функции общего назначения]]}}<br />
Функция создает на сервере массив по его имени, с указанным разделителем значений и префиксов и указанными параметрами, задающимися в виде списка, и возвращает идентификатор созданного массива. Если массив уже существует, будет возвращен его идентификатор без каких-либо дополнительных изменений.<br />
== Синтаксис ==<br />
<code><br />
'''GlobalStringsHeapsAdd'''(''<Имя массива (STRING)>''{{Optional|,<Строка-разделитель (STRING)>{{Default|{{Eq}}Chr(0)}},<Разделитель префикса (STRING)>{{Default|{{Eq}}""}},<Параметры массива (LIST)>}}):''<Идентификатор массива (INT)>''<br />
</code><br />
==== Аргументы ====<br />
* <code>''<Имя массива (STRING)>''</code> - Параметр задает имя массива для создания. Имя может содержать международные символы.<br />
* <code>''<Строка-разделитель (STRING)>''</code> - {{Optional}} Параметр задает строку-разделитель для строк массива. Строки массива не должны будут содержать эту комбинацию символов. Если параметр не задан, будет использован разделитель, состоящий из одного символа с кодом 0.<br />
* <code>''<Разделитель префикса (STRING)>''</code> - {{Optional}} Параметр задает строку-разделитель префикса строки массива от ее значения. Префикс не участвует в поиске и может содержать произвольную текстовую информацию произвольной длины. Наличие префикса не является обязательным для определенной строки массива, даже если он задан при его создании. Если параметр не задан, массив не будет содержать префиксов, только значения.<br />
* <code>''<Параметры массива (LIST)>''</code> - {{Optional}} Параметр задает дополнительные установки массива и является списком, наименования элементов которого задают наименование параметров, а значения элементов, являются значениями установок. На данный момент доступны следующие установки:<br />
** <code>FileName</code> -- задает путь к файлу сохранения массива на сервере. Если установка не указана, автоматического сохранения массива не будет выполняться. Если установка задана, будет произведена попытка чтения файла для начального заполнения массива.<br />
** <code>BucketSize</code> -- задает размер одного буфера строк массива. Чем больше значение, тем быстрее будет работать массив, однако, слишком большие значения фрагментируют память на сервере, замедляя его работу.<br />
** <code>AutoShrink</code> -- задает количество удалений, после которого автоматически будет выполнена операция сжатия массива (реконфигурация строк таким образом, чтобы они занимали меньший размер буфера). Если параметр не задан, автоматическое сжатие не будет производиться и его необходимо будет выполнять периодически с помощью функции [[GlobalStringsShrink]].<br />
** <code>AutoShinkThreshold</code> -- {{Planned}} задает процент свободного места в данных буфера по отношению к размеру данных в буфере для инициации автоматической процедуры сжатия для буфера. По умолчанию -- 50%.<br />
** <code>AutoSavePeriod</code> -- задает минимальное время в миллисекундах, которое должно пойти с момента автоматического сохранения массива на диске до момента его следующего сохранения. Автоматическое сохранение производится только при наличии изменений в массиве. Если установка не задана, автоматическое сохранение выполняться не будет.<br />
==== Возвращаемое значение ====<br />
Возвращает числовое значение -- идентификатор массива на сервере.<br />
<br />
== Примеры ==<br />
<pre><br />
аДата:=BegOfDay(Date());<br />
aList:=List.Create();<br />
aList["BucketSize"]:=1024*1024;//1Мб буфер<br />
aList["AutoShrink"]:=250;//Сжимать после 250 удалений<br />
aList["AutoSavePeriod"]:=60000;//Сохранять не чаще одной минуты<br />
aList["FileName"]:="Temp\МассивыСтрок\"+FormatDate(аДата,"YYYYmmdd")+".bin";<br />
аМассив:=GlobalStringsHeapsAdd("MRK"+FormatDate(аДата,"YYYYmmdd"),Chr(0),Chr(1),aList);<br />
</pre></div>1>Admin