Admin: 1 revision imported

2022-09-07T12:20:49Z

1 revision imported

1>Admin at 10:29, 16 August 2022

2022-08-16T10:29:45Z

Admin: 1 revision imported

2022-07-17T11:22:20Z

1 revision imported

1>Admin at 06:50, 17 July 2022

2022-07-17T06:50:41Z

New page

{{infobox function
|name=LoadJSONFromString
|caption=Функции работы со строками
|type=1
|status=1
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция загружает часть текста или весь текст в формате JSON и возвращает его представление в виде объекта дерева или списка. Функция загружает текст JSON от начала строки до того, как системе встречается знак закрытия массива, идущий вне исходного уровня или какой-либо ошибочный знак. От начала строки текста, при этом, будет удалена загруженная подстрока. Таким образом, можно загружать очень большой текст, содержащий заранее известные элементы массива постепенно. Корректный текст JSON будет загружен полностью.

Комментарии по работе функции:
* В создаваемых объектах функция также использует поле ''Check'' (как в дереве, так и в списках). Если это поле установлено, элемент включает массив ('''[...]'''), иначе включает объект ('''{...}'''). Такой подход необходим для корректной работы функции [[SaveJSONToString]], так как без него система не отличить пустой объект ''{}'' от пустого массива ''[]''.
* Булевский тип (''true'' или ''false'') будет загружен как текст "true" или "false". Поле ''Check'' этой ветки или элемента изменяется на 2, для того, чтобы этот объект можно было отличить от строки (если в этом есть необходимость).
* Пустой тип (''null'') будет загружен как текст "null". Поле ''Check'' этой ветки или элемента изменяется на 3, для того, чтобы этот объект можно было отличить от строки.

== Синтаксис ==
<code>
'''LoadJSONFromString'''({{ByRef|<Строка (STRING)>}}{{Optional|,''<Тип возвращаемого объекта (INT)>''{{Default|{{Eq}}0}}}}):''<Результат (TREE,LIST)>''
</code>
==== Аргументы ====
* <code>''<Строка (STRING)>''</code> - {{ByRef}} Аргумент содержит строку в формате JSON. Если будет загружена только часть строки, в переменной аргумента будет возвращена незагруженная часть. Если строка загружается полностью (корректный объект JSON), в переменной аргумента будет возвращена пустая строка.
* <code>''<Тип возвращаемого объекта (INT)>''</code> - {{Optional}} Аргумент задает тип возвращаемого функцией объекта, и может принимать следующие значения:
** '''0''' (по умолчанию): Функция возвратит объект дерева.
** '''1''': Функция возвратит объект списка, который будет содержать другие списки, представляющие массивы исходного объекта JSON.

==== Возвращаемое значение ====
Будет возвращен либо объект дерева, либо объект списка, в зависимости от значения второго аргумента.

== Примеры ==
<pre>
//Загрузка простого объекта JSON
Стр:=FileToString("C:\Temp\Object.json",65001);
aTree:=LoadJSONFromString(Стр,0);
aBr:=aTree["Результат","Вложения"];
Message("Файлы ветки Вложения:");
If _And(TypeStr(aBr)="TREE.BRANCH",aBr.Size()>0) Then
For i:=1 to aBr.Size() Do
Message("Файл вложения: "+aBr[i,"Файл","Имя"]);
EndDo;
EndIf;
</pre>

<pre>
//Загрузка JSON по этапам
Стр:="{""Вложения"":[{""Файл"":{""Имя"":""Файл1"",""Тип"":0},""Удален"":0},{""Файл"":{""Имя"":""Файл2"",""Тип"":1},""Удален"":1},{""Файл"":{""Имя"":""Файл3"",""Тип"":2},""Удален"":0}]}";
TearStr(Стр,"{""Вложения"":[");
While Стр<>"" Do
aTree:=LoadJSONFromString(Стр,0);
//Загрузка остановится на знаке ","
TearStr(Стр,",");
If aTree.Size()>0 Then
Message("Файл: "+aTree["Файл","Имя"]);
EndIf;
EndDo;
//Будет выведено:
//Файл: Файл1
//Файл: Файл2
//Файл: Файл3
</pre>

← Older revision	Revision as of 12:20, 7 September 2022
(No difference)

@@ Line 17: / Line 17: @@
 * Булевский тип (''true'' или ''false'') будет загружен как текст "true" или "false". Поле ''Check'' этой ветки или элемента изменяется на 2, для того, чтобы этот объект можно было отличить от строки (если в этом есть необходимость).
 * Пустой тип (''null'') будет загружен как текст "null". Поле ''Check'' этой ветки или элемента изменяется на 3, для того, чтобы этот объект можно было отличить от строки.
 == Синтаксис ==

← Older revision	Revision as of 11:22, 17 July 2022
(No difference)

LoadJSONFromString - Revision history

Admin: 1 revision imported

1>Admin at 10:29, 16 August 2022

Admin: 1 revision imported

1>Admin at 06:50, 17 July 2022