FUNCTION StrToNum(sTagValue VARCHAR2, iStrict PLS_INTEGER := 0) RETURN NUMBER;

Извлекает значение типа Number из текста элемента.
Параметры:

• sTagValue - значение числа;
  
• iStrict - определяет поведение при некорректном значении.
  

При пустом значении sTagValue возвращает null.

FUNCTION DateToStr(dDate DATE, iAddTimezone PLS_INTEGER := 0) RETURN VARCHAR2;

Преобразует значение типа Date в текстовый формат.
Параметры:

• dDate - преобразуемое значение даты;
  
• iAddTimezone - добавлять ли часовой пояс (0/1).
  

Добавляемый часовой пояс берётся из текущих настроек ОС.
Если dDate=null, возвращает null.

FUNCTION StrToDate(sTagValue VARCHAR2, iStrict PLS_INTEGER := 0) RETURN DATE;

Извлекает значение типа Date из текста элемента.
Параметры:

• sTagValue - значение даты в формате ISO yyyy-mm-ddZ;
  
• iStrict - определяет поведение при некорректном значении.
  

Часовой пояс игнорируется (отбрасывается).
При пустом значении sTagValue возвращает null.

FUNCTION DateTimeToStr(dDate DATE, iAddTimezone PLS_INTEGER := 1) RETURN VARCHAR2;

Преобразует значение даты и времени типа Date в текстовый формат.
Параметры:

• dDate - преобразуемое значение даты и времени;
  
• iAddTimezone - добавлять ли часовой пояс (0/1).
  

Добавляемый часовой пояс берётся из текущих настроек ОС.
Если dDate=null, возвращает null.

FUNCTION StrToDateTime(sValue VARCHAR2, iUseTZ PLS_INTEGER := 0, iStrict PLS_INTEGER := 0) RETURN DATE;

Извлекает значение типа DateTime из текста элемента.
Параметры:

• sValue - значение даты и времени;
  
• iUseTZ - определяет, учитывать ли часовой пояс (0/1);
  
• iStrict - определяет поведение при некорректном значении.
  

Если учитывается часовой пояс, то время приводится к часовому поясу ОС, иначе часовой пояс в значении просто
отбрасывается.
При пустом значении sValue возвращает null.

FUNCTION TimestampToStr(tValue TIMESTAMP, iAddTimezone PLS_INTEGER := 1) RETURN VARCHAR2;

Преобразует значение типа Timestamp в текстовый формат.
Параметры:

• tValue - значение даты и времени;
  
• iAddTimezone - добавлять ли часовой пояс (0/1).
  

Добавляемый часовой пояс берётся из текущих настроек ОС.
Если tValue=null, возвращает null.

FUNCTION StrToTimestamp(sValue VARCHAR2, iUseTZ PLS_INTEGER := 1, iStrict PLS_INTEGER := 1) RETURN TIMESTAMP;

Извлекает значение типа Timestamp из текста элемента.
Параметры:

• sValue - значение даты и времени;
  
• iUseTZ - определяет, учитывать ли часовой пояс (0/1);
  
• iStrict - определяет поведение при некорректном значении.
  

Если учитывается часовой пояс, то время приводится к часовому поясу ОС, иначе часовой пояс в значении просто
отбрасывается.
При пустом значении sValue возвращает null.

FUNCTION BoolStrToInt(sValue VARCHAR2, iStrict PLS_INTEGER) RETURN PLS_INTEGER deterministic;

Преобразует текстовое представление значения xs:boolean в числовое. Значения '1', 'true' преобразуются в 1; Значения '0', 'false' преобразуются в 1. В остальных случаях поведение определяется параметром iStrict.

FUNCTION GMonthStrToInt(sValue VARCHAR2, iStrict PLS_INTEGER) RETURN PLS_INTEGER deterministic;

Преобразует текстовое представление значения xs:gMonth (формат –MM) в числовое. Информация о часовом поясе игнорируется. Если значение некорректно, поведение определяется параметром iStrict.

FUNCTION GYearMonthStrToDate(sValue VARCHAR2, iStrict PLS_INTEGER) RETURN DATE deterministic;

Преобразует текстовое представление значения xs:gYearMonth (формат YYYY-MM) дату (начало соответствующего месяца). Информация о часовом поясе игнорируется. Отрицательный номер года не поддерживается. Если значение некорректно, поведение определяется параметром iStrict.

FUNCTION QName(sNSPrefix VARCHAR2, sLocalName VARCHAR2) RETURN VARCHAR2 deterministic;

Добавляет префикс пространства имён к локальному имени.

FUNCTION OpenTag(sTag VARCHAR2, sAttribs VARCHAR2 := NULL, sNSPrefix VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Возвращает текст строки для открытия тега.
Параметры:

• sTag - наименование тега;
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела);
  
• sNSPrefix - префикс пространства имён.

FUNCTION CloseTag(sTag VARCHAR2, sNSPrefix VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Возвращает текст строки для закрытия тега.
Параметры:

• sTag - наименование тега;
  
• sNSPrefix - префикс пространства имён.

FUNCTION MakeEmptyTag(sTag VARCHAR2, sAttribs VARCHAR2, sNSPrefix VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Создаёт и возвращает тег XML без текста.
Параметры:

• sTag - наименование тега;
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела);
  
• sNSPrefix - префикс пространства имён.
  

При отсутствии атрибутов возвращает null.

FUNCTION MakeMandatoryEmptyTag(sTag VARCHAR2, sAttribs VARCHAR2 := NULL, sNSPrefix VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Создаёт и возвращает тег XML без текста.
Параметры:

• sTag - наименование тега;
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела);
  
• sNSPrefix - префикс пространства имён.
  

При отсутствии атрибутов возвращает пустой тег без атрибутов.

FUNCTION MakeTag(sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Создаёт и возвращает тег XML.
Параметры:

• sTag - наименование тега;
  
• sTagValue - текст тега (для Varchar-версии);
  
• cTagValue - текст тега (для CLOB-версии);
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела);
  
• sDelimiter - разделитель между открывающей, закрывающей частями и текстом тега; игнорируется, если текст тега отсутствует.
  

Если текст тега отсутствует, возвращает пустой тег с атрибутами.
Если отсутствуют и текст тега, и атрибуты, возвращает null.

FUNCTION MakeTag(sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeQTag(sNSPrefix VARCHAR2, sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Аналогична MakeTag, но с возможностью задать префикс пространства имён.

FUNCTION MakeQTag(sNSPrefix VARCHAR2, sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeMandatoryTag(sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Создаёт и возвращает тег XML.
Параметры:

• sTag - наименование тега;
  
• sTagValue - текст тега (для Varchar-версии);
  
• cTagValue - текст тега (для CLOB-версии);
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела);
  
• sDelimiter - разделитель между открывающей, закрывающей частями и текстом тега; игнорируется, если текст тега отсутствует.
  

Если текст тега отсутствует, возвращает пустой тег с атрибутами.
Если отсутствуют и текст тега, и атрибуты, возвращает пустой тег без атрибутов.

FUNCTION MakeMandatoryTag(sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeMandatoryQTag(sNSPrefix VARCHAR2, sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Аналогична MakeMandatoryTag, но с возможностью задать префикс пространства имён.

FUNCTION MakeMandatoryQTag(sNSPrefix VARCHAR2, sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL, sDelimiter VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeTagLn(sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Создаёт и возвращает тег, используя в качестве разделителя между открывающей, закрывающей частями и текстом тега
перенос строки.
Параметры:

• sTag - наименование тега;
  
• sTagValue - текст тега (для Varchar-версии);
  
• cTagValue - текст тега (для CLOB-версии);
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела).
  

Если текст тега отсутствует, возвращает пустой тег с атрибутами.
Если отсутствуют и текст тега, и атрибуты, возвращает null.

FUNCTION MakeTagLn(sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeQTagLn(sNSPrefix VARCHAR2, sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Аналогична MakeTagLn, но с возможностью задать префикс пространства имён.

FUNCTION MakeQTagLn(sNSPrefix VARCHAR2, sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeMandatoryTagLn(sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Создаёт и возвращает тег, используя в качестве разделителя между открывающей, закрывающей частями и текстом тега
перенос строки.
Параметры:

• sTag - наименование тега;
  
• sTagValue - текст тега (для Varchar-версии);
  
• cTagValue - текст тега (для CLOB-версии);
  
• sAttribs - список атрибутов тега (если не пустой, должен начинаться с пробела).
  

Если текст тега отсутствует, возвращает пустой тег с атрибутами.
Если отсутствуют и текст тега, и атрибуты, возвращает пустой тег без атрибутов.

FUNCTION MakeMandatoryTagLn(sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL) RETURN CLOB deterministic;

FUNCTION MakeMandatoryQTagLn(sNSPrefix VARCHAR2, sTag VARCHAR2, sTagValue VARCHAR2, sAttribs VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Аналогична MakeMandatoryTagLn, но с возможностью задать префикс пространства имён.

FUNCTION MakeMandatoryQTagLn(sNSPrefix VARCHAR2, sTag VARCHAR2, cTagValue IN CLOB, sAttribs VARCHAR2 := NULL) RETURN CLOB deterministic;

PROCEDURE AppendLn(cTarget IN OUT NOCOPY CLOB, cLine IN CLOB, sDelimiter VARCHAR2 := Cr);

Добавляет одну строку к другой через разделитель.
Параметры:

• cTarget - строка-приёмник;
  
• cLine - добавляемая строка;
  
• sDelimiter - разделитель между строками; если одна из строк пустая, разделитель игнорируется.
  

Если добавляемая строка пустая, строка-приёмник остаётся без изменений.

PROCEDURE AppendStrLn(sTarget IN OUT NOCOPY VARCHAR2, sLine VARCHAR2, sDelimiter VARCHAR2 := Cr);

Аналогична AppendLn, но для Varchar2.

PROCEDURE AppendStrToCLOBLn(cTarget IN OUT NOCOPY CLOB, sLine VARCHAR2, sDelimiter VARCHAR2 := Cr);

Аналогична AppendLn, но для добавления Varchar2 к CLOB.

PROCEDURE AddAttr(sAttribs IN OUT NOCOPY VARCHAR2, sAttrName VARCHAR2, sAttrValue VARCHAR2, sNSPrefix VARCHAR2 := NULL);

Дополняет атрибут в список атрибутов XML-тега, если значение атрибута не пустое.
Параметры:

• sAttribs - список атрибутов;
  
• sAttrName - наименование атрибута;
  
• sAttrValue - значение атрибута;
  
• sNSPrefix - префикс пространства имён.
  

Если значение атрибута пустое, список атрибутов остаётся без изменений.

PROCEDURE AddMandatoryAttr(sAttribs IN OUT NOCOPY VARCHAR2, sAttrName VARCHAR2, sAttrValue VARCHAR2, sNSPrefix VARCHAR2 := NULL);

Добавляет атрибут в список атрибутов XML-тега, если значение атрибута не пустое.
Параметры:

• sAttribs - список атрибутов;
  
• sAttrName - наименование атрибута;
  
• sAttrValue - значение атрибута;
  
• sNSPrefix - префикс пространства имён.
  

Если значение атрибута пустое, атрибут добавляется с пустым значением (””).
В процессе формирования списка атрибутов пробел добавляется не только между атрибутами, но и в начало списка.

PROCEDURE AddNSAttr(sAttribs IN OUT NOCOPY VARCHAR2, sNSPrefix VARCHAR2, sNSURI VARCHAR2);

Добавляет атрибут пространства имён.
Параметры:

• sAttribs - изменяемый список атрибутов;
  
• sNSPrefix - префикс пространства имён; если null, добавляется атрибут пространства имён по умолчанию;
  
• sNSURI - sNSURI - URI пространства имён.

FUNCTION Escape(sValue VARCHAR2) RETURN VARCHAR2 deterministic;

Заменяет специальные символы на соответствующие выражения (< и т.п.).

FUNCTION Escape(cValue IN CLOB) RETURN CLOB deterministic;

FUNCTION ReplaceWhitespace(sValue VARCHAR2) RETURN VARCHAR2 deterministic;

Выполняет обработку whitespace-символов в соответствии со спецификацией xmlschema: все последовательные символы #9, #10, #13, ' ' заменяются одиночным пробелом.

FUNCTION CollapseWhitespace(sValue VARCHAR2) RETURN VARCHAR2 deterministic;

Выполняет обработку whitespace-символов в соответствии со спецификацией xmlschema: 1. Все последовательные символы #9, #10, #13, ' ' заменяются одиночным пробелом. 2. После этого ведущие и терминирующие пробелы удаляются.

FUNCTION XMLTRANSFORM(bData BLOB, bTransform BLOB) RETURN BLOB;

Выполняет XSLT-преобразование над XML-данными.
Параметры:

• bData - исходные XML-данные;
  
• bTransform - XSLT-преобразование.
  

Возвращает результат преобразования или null, если хотя бы один из входных параметров равен null.

FUNCTION XMLTRANSFORM(bData BLOB, sTransform VARCHAR2) RETURN BLOB;

Выполняет XSLT-преобразование над XML-данными.
Параметры:

• bData - исходные XML-данные;
  
• sTransform - URL XSLT-преобразования.
  

Возвращает результат преобразования или null, если хотя бы один из входных параметров равен null.