ReformatXML - Revision history

Admin: 1 revision imported

2025-01-22T06:55:46Z

1 revision imported

1>Admin at 12:14, 5 January 2025

2025-01-05T12:14:14Z

Admin: 1 revision imported

2021-06-28T07:04:26Z

1 revision imported

1>Admin at 10:43, 10 June 2021

2021-06-10T10:43:48Z

Admin: 1 revision imported

2021-04-16T14:18:27Z

1 revision imported

1>Admin at 16:57, 16 March 2021

2021-03-16T16:57:52Z

Admin: 1 revision imported

2021-02-07T06:52:36Z

1 revision imported

Admin at 06:32, 24 October 2020

2020-10-24T06:32:18Z

New page

{{infobox function
|name=ReformatXML
|caption=Функции работы со строками
|type=1
|status=1
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция приводит текст в XML нотации к каноническому простому виду с тем, чтобы его можно было разобрать обычными текстовыми функциями. Позволяет настроить глубину упрощения текста. Функция оптимизирована для работы с большими файлами. Функция принимает как строковой аргумент, так и объекты вида [[Текст|TEXT]]. Строковой аргумент будет превращен в строку UTF-16 перед обработкой.<br />
Функция принимает как аргументы, с разделителями _NEWLINE (<code>Chr(13)+Chr(10)</code>), с разделителями Chr(10), так и аргументы, использующие смешанные разделители _NEWLINE и chr(10). Результат всегда будет иметь разделители _NEWLINE (<code>Chr(13)+Chr(10)</code>).<br />
Без учета дополнительных режимов, функция производит в исходной строке следующие изменения:
* Сохраняет все данные, идущие до первого тега <code><...></code> в оригинальном виде без изменения (однако, знаки переноса строк (см. выше) приводятся к одному виду по всему тексту). Если в тексте до начала xml встречается знак '''<''', он будет расценен, как начало xml, поэтому, начальный текст не должен содержать знаков '''<''', иначе он будет искажен.
* Сохраняет все данные, идущие после последнего закрывающегося значащего xml тега, с учетом условий предыдущего пункта.
* Размещает каждый новый тег на новой строке. Если тег включает подтеги, конструкция закрытия оного будет следовать отдельной строкой, если тег не включает подтегов, то закрытие тега будет следовать той же самой строкой.
* Знаки перевода строк удаляются из значений тегов.
* Особые теги <code><?... ?></code>, <code><!... ></code>, <code></code>, не имеющие закрывающих конструкций, всегда будут следовать отдельными строками и иметь перенос сразу после завершения.
* Все незначащие пробелы, табуляции и переносы строк (в т.ч. между тегами) будут удалены.

== Синтаксис ==
<code>
'''ReformatXML'''(''<Строка>''{{Optional|,''<Режимы (INT)>''{{Default|{{Eq}}3}}}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Строка>''</code> - Аргумент, строковое представление которого необходимо переформатировать. Данный аргумент может также содержать объект, имеющий вид [[Текст|TEXT]].
* <code>''<Режимы (INT)>''</code> - {{Optional}} Аргумент, числовое представление которого представляет режим перекодировки. Режим является битовой маской, следующие биты могут быть использованы:
** '''Бит 0''' (маска 1, по умолчанию): Функция также удалит все HTML комментарии из текста (т.е. будут удалены все межтеговые встречающиеся комбинации <code></code>. Без использования данного режима, наличие комментариев в случайном месте может сделать невозможным корректный разбор текста простым способом.
** '''Бит 1''' (маска 2, по умолчанию): Функция также удалит все XML именные пространства (т.е. комбинации, типа <code><NameSpace:Tag xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="1.0">123</Tag></code> будут превращены в <code><Tag Version="1.0">123</Tag></code>. Стандарт xml подразумевает использование именных пространств с любыми именами в любом количестве в любом из тегов, что может сделать невозможным корректный разбор текста простым способом. После удаления всех именных пространств, полученный xml будет по-прежнему соответствовать исходному.
** '''Бит 2''' (маска 4): {{Planned}} Функция будет сортировать расположение тегов по именам, сохраняя при этом структуру подтегов (которые в свою очередь будут подвергаться сортировке). Сортировка ведется быстрым способом по кодам символов (т.е. '''A'''<'''a'''). К примеру, строка <code><Sales Type="1">1111.11</Sales><Country><Name /></Country></code> будет отсортирована в <code><Country><Name /></Country><Sales Type="1">1111.11</Sales></code>. Иногда при получении xml одного формата из разных источников, теги могут быть перепутаны местами или следовать в разной последовательности, такая ситуация может усложнить разбор текста простым способом.
** '''Бит 3''' (маска 8): Все имена тегов (включая особые самозакрывающиеся теги <code><?... ?></code> и <code><!... ></code>) будут приведены к верхнему регистру. Пример: <code><Sales Type="1">1111.11</Sales><Country><Name /></Country></code> превратится в <code><SALES Type="1">1111.11</SALES><COUNTRY><NAME /></COUNTRY></code>. Иногда при получении xml одного формата из разных источников, теги могут иметь имена в разном регистре, даже с учетом того, что формат xml различает регистр наименований тегов, и подобные файлы уже не будут считаться одинаковыми. Такая ситуация может усложнить разбор текста простым способом, данный режим помогает избежать этой проблемы (но не рекомендуется к использованию, если известно, что файл создан с требуемым регистром тегов).
** '''Бит 4''' (маска 16): Будет считаться, что файл не содержит постороннего текста, кроме xml. Весь текст, идущий до первого тега и после последнего тега будет подвергаться такой же обработке, как и текст во внутритеговом пространстве (т.е, будут удалены переводы строки и пр.). Данная опция может использоваться в файлах, которые до начала xml содержат какой-то текст. Такие файлы, однако, не рекомендуется разбирать этой функцией.
** '''Бит 5''' (маска 32): Все самозакрывающиеся теги будут превращены в пару -- открывающийся и закрывающийся. К примеру <code><Sales Invoice="123" /></code> будет превращено в <code><Sales Invoice="123"></Sales></code>

==== Возвращаемое значение ====
Результат будет возвращен в UTF-16, если исходный аргумент был текстом, а не строкой, результат возвращен не будет, объект первого аргумента будет обновлен значением результата. Если текст был в формате ANSI, при обновлении будет произведена перекодировка в ANSI.

== Примеры ==
<pre>
Стр:="Проверка текста, идущего до первого тега
|Проверка-2
|<?xml version=""1.0"" encoding=""utf-8""?> 
| <СлучайноеИмя:Project xmlns=""http://schemas.microsoft.com/developer/msbuild/2003"" xmlns:СлучайноеИмя=""http://site.org/WSITE/WSCHEMA"" >
| <СлучайноеИмя:PropertyGroup> <ProjectGuid>{77777777-0000-4444-9999-EEEEEEEEEEEE}</ProjectGuid> </СлучайноеИмя:PropertyGroup>
| <СлучайноеИмя:ItemGroup>
|
| <Projects
| Include=""Путь\Имя.dproj"">
| <Dependencies/>
| </Projects>
| </СлучайноеИмя:ItemGroup>
| <Sales "+chr(9)+"Invoice=""123"" />
|</СлучайноеИмя:Project>Проверка текста за последним тегом";

Message(ReformatXML(Стр,1+2+8+16+32));
</pre>

Результатом работы примера станет следующая строка:
<pre>
Проверка текста, идущего до первого тега Проверка-2
<?XML version="1.0" encoding="utf-8"?>
<PROJECT>
<PROPERTYGROUP>
<PROJECTGUID>{77777777-0000-4444-9999-EEEEEEEEEEEE}</PROJECTGUID>
</PROPERTYGROUP>
<ITEMGROUP>
<PROJECTS Include="Путь\Имя.dproj">
<DEPENDENCIES></DEPENDENCIES>
</PROJECTS>
</ITEMGROUP>
<SALES Invoice="123"></SALES>
</PROJECT>
Проверка текста за последним тегом
</pre>

@@ Line 36: / Line 36: @@
 ** '''Бит 5''' (маска 32): Все самозакрывающиеся теги будут превращены в пару -- открывающийся и закрывающийся. К примеру <code>&lt;Sales Invoice="123" /></code> будет превращено в <code>&lt;Sales Invoice="123">&lt;/Sales></code>
 ** '''Бит 6''' (маска 64): Все пробелы перед и после текста внутри тегов будут сохранены (пример: <code><nowiki><Tag>&nbsp;Текст&nbsp;&nbsp;</Tag></nowiki></code> ''не'' превратится в <code><nowiki><Tag>Текст</Tag></nowiki></code>). Также все переносы строк внутри текста тегов будут сохранены и кодированы (кодирование необходимо, чтобы не нарушилось правило "одна строка -- один тег"), (пример: <code><nowiki><Tag>Текст<_NEWLINE>Текст 2</Tag></nowiki></code> превратится в <code><nowiki><Tag>Текст&amp;#13;&amp;#10;Текст 2</Tag></nowiki></code>).
 ==== Возвращаемое значение ====

@@ Line 17: / Line 17: @@
 * Сохраняет все данные, идущие после последнего закрывающегося значащего xml тега, с учетом условий предыдущего пункта.
 * Размещает каждый новый тег на новой строке. Если тег включает подтеги, конструкция закрытия оного будет следовать отдельной строкой, если тег не включает подтегов, то закрытие тега будет следовать той же самой строкой.
-* Знаки перевода строк удаляются из значений тегов.
+* Знаки перевода строк удаляются из значений тегов (режим может быть отключен, см. ниже).
 * Особые теги <code><?... ?></code>, <code><!... ></code>, <code>&lt;!--... --></code>, не имеющие закрывающих конструкций, всегда будут следовать отдельными строками и иметь перенос сразу после завершения.
-* Все незначащие пробелы, табуляции и переносы строк (в т.ч. между тегами) будут удалены.
+* Все незначащие пробелы, табуляции и переносы строк (в т.ч. между тегами) будут удалены (режим может быть отключен для значений внутри тегов, см. ниже).
 * Значения атрибутов, ограниченные апострофами <code><img src='example.jpg'></code> будут приведены к стандартному написанию с использованием знаков кавычек <code><img src="example.jpg"></code> (возможные существующие кавычки внутри строки атрибута будут HTML-кодированы). Однако, написание атрибутов внутри особых тегов (см. выше) не будет изменено.

← Older revision	Revision as of 06:55, 22 January 2025
(No difference)

← Older revision	Revision as of 07:04, 28 June 2021
(No difference)

← Older revision	Revision as of 14:18, 16 April 2021
(No difference)

@@ Line 20: / Line 20: @@
 * Особые теги <code><?... ?></code>, <code><!... ></code>, <code>&lt;!--... --></code>, не имеющие закрывающих конструкций, всегда будут следовать отдельными строками и иметь перенос сразу после завершения.
 * Все незначащие пробелы, табуляции и переносы строк (в т.ч. между тегами) будут удалены.
 == Синтаксис ==
 <code>
-'''ReformatXML'''(''<Строка>''{{Optional|,''<Режимы (INT)>''{{Default|{{Eq}}3}}}}):''<Результат (STRING)>''
+'''ReformatXML'''(''<Строка или текст (STRING,TEXT)>''{{Optional|,''<Режимы (INT)>''{{Default|{{Eq}}3}}}}):''<Результат (STRING)>''
 </code>
 ==== Аргументы ====
-* <code>''<Строка>''</code> - Аргумент, строковое представление которого необходимо переформатировать. Данный аргумент может также содержать объект, имеющий вид [[Текст|TEXT]].
+* <code>''<Строка или текст (STRING,TEXT)>''</code> - Аргумент, строковое представление которого необходимо переформатировать. Данный аргумент может также содержать объект, имеющий вид [[Текст|TEXT]].
 * <code>''<Режимы (INT)>''</code> - {{Optional}} Аргумент, числовое представление которого представляет режим перекодировки. Режим является битовой маской, следующие биты могут быть использованы:
 ** '''Бит 0''' (маска 1, по умолчанию): Функция также удалит все HTML комментарии из текста (т.е. будут удалены все межтеговые встречающиеся комбинации <code>&lt;!-- ... --></code>. Без использования данного режима, наличие комментариев в случайном месте может сделать невозможным корректный разбор текста простым способом.
@@ Line 34: / Line 35: @@
 ** '''Бит 4''' (маска 16): Будет считаться, что файл не содержит постороннего текста, кроме xml. Весь текст, идущий до первого тега и после последнего тега будет подвергаться такой же обработке, как и текст во внутритеговом пространстве (т.е, будут удалены переводы строки и пр.). Данная опция может использоваться в файлах, которые до начала xml содержат какой-то текст. Такие файлы, однако, не рекомендуется разбирать этой функцией.
 ** '''Бит 5''' (маска 32): Все самозакрывающиеся теги будут превращены в пару -- открывающийся и закрывающийся. К примеру <code>&lt;Sales Invoice="123" /></code> будет превращено в <code>&lt;Sales Invoice="123">&lt;/Sales></code>
 ==== Возвращаемое значение ====
-Результат будет возвращен в UTF-16, если исходный аргумент был текстом, а не строкой, результат возвращен не будет, объект первого аргумента будет обновлен значением результата. Если текст был в формате ANSI, при обновлении будет произведена перекодировка в ANSI.
+Результат будет возвращен в UTF-16. Если исходный аргумент был текстом, а не строкой, результат возвращен не будет, объект первого аргумента будет обновлен значением результата. Если текст был в формате ANSI, при обновлении будет произведена перекодировка в ANSI.
 == Примеры ==

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)