FUNCTION GetLastDate RETURN DATE deterministic;

Возвращают LastDate и FirstDate соответственно.

FUNCTION GetFirstDate RETURN DATE deterministic;

PROCEDURE Error_InternalError(sMsg VARCHAR2);

Вызывает exception «Внутренняя ошибка».

PROCEDURE Error_InvalidParameters(sMsg VARCHAR2);

Вызывает exception «Недопустимые параметры».

PROCEDURE Error_UnimplementedFeature(sFeatureName VARCHAR2);

Вызывает exception «Данная возможность не реализована».

PROCEDURE Error_NotAUser(sRequiredUserName VARCHAR2);

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

PROCEDURE InsufficientPrivs(sOperation VARCHAR2 := NULL);

Вызывает exception «Недостаточно привилегий на операцию».

PROCEDURE Error_InvalidKeyList(s VARCHAR2);

Вызывает exception «Недопустимый список региональных ключей».

PROCEDURE Error_InvalidGlobalSeqID(iID PLS_INTEGER);

Вызывает exception «Глобальная последовательность не найдена».

PROCEDURE Error_InvalidRgnSeqID(iID PLS_INTEGER);

Вызывает exception «Региональная последовательность не найдена».

FUNCTION GetDBCharset RETURN VARCHAR2;

Возвращает наименование текущей кодировки в БД.

FUNCTION FixLineBreaksLinux(s VARCHAR2) RETURN VARCHAR2 deterministic;

Преобразует переводы строк в формат Linux (LF).

FUNCTION FixLineBreaksWindows(s VARCHAR2) RETURN VARCHAR2 deterministic;

Преобразует переводы строк в формат Windows (CR+LF).

FUNCTION BracedParamsToBoundVars(sSQL VARCHAR2, Params uszn.TStringList30) RETURN VARCHAR2;

Заменяет параметры в фигурных скобках на binded-параметры.
Параметры:

• sSQL - SQL-выражение, содержащее параметры в фигурных скобках;
  
• Params - список имён параметров, которые требуется заменять.

FUNCTION TrimWhitespace(s VARCHAR2, sWhitespaceChars VARCHAR2 := ' '||Chr(9)||Chr(10)||Chr(13)) RETURN VARCHAR2 deterministic;

Удаляет ведущие и терминирующие символы пробелов.

FUNCTION RemoveLastOrderBy(sSQL VARCHAR2) RETURN VARCHAR2 deterministic;

Удаляет последнее выражение order by из SQL-оператора select.

FUNCTION Quote(s VARCHAR2, sQuoteChar VARCHAR2 := '''') RETURN VARCHAR2 deterministic;

Заключает строку в указанный символ кавычки, дублируя также встречающиеся символы кавычки.

FUNCTION Dequote(s VARCHAR2, sQuoteChar VARCHAR2 := '''', iStrict PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Функция, обратная Quote; если исходная строка невалидна, при iStrict=0 возвращает null, иначе возникает exception.

FUNCTION ShortenStr(s VARCHAR2, iMaxLength PLS_INTEGER, iKeepLineBreaks PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

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

• s - исходная строка;
  
• iMaxLength - максимальная допустимая длина результирующей строки;
  
• iKeepLineBreaks - усекать ли символы перевода строки Chr(13)||Chr(10) сразу оба (1) или оставлять при необходимости только один из них (0).

FUNCTION Transliterate(s VARCHAR2, iFullCaps PLS_INTEGER, iSkipSigns PLS_INTEGER) RETURN VARCHAR2 deterministic;

Выполняет транслитерацию русских символов в английские.
Параметры:

• s - исходная строка;
  
• iFullCaps - транслитерировать ли буквы “Ё”, “Ж” и т. п. полностью в верхний регистр (YO, ZH) (0/1);
  
• iSkipSigns - опустить ли при транслитерации мягкие и твёрдые знаки (0/1).

FUNCTION ConcWords(s1 VARCHAR2, s2 VARCHAR2) RETURN VARCHAR2 deterministic;

Если s1 и s2 не пустые, возвращает s1||s2, иначе - пустую строку.

FUNCTION ConcWordsSpc(s1 VARCHAR2, s2 VARCHAR2) RETURN VARCHAR2 deterministic;

Если s1 и s2 не пустые, возвращает s1||' '||s2, иначе - s1||s2.

FUNCTION ConcWordsDelim(s1 VARCHAR2, s2 VARCHAR2, sDelim VARCHAR2) RETURN VARCHAR2 deterministic;

Если s1 и s2 не пустые, возвращает s1||sDelim||s2, иначе - s1||s2.

FUNCTION ConvertHomoglyphsRuEn(sInput VARCHAR2, iToRussian PLS_INTEGER) RETURN VARCHAR2 deterministic;

Преобразует гомоглифы (одинаково выглядящие символы) из русского варианта в английский и обратно.

FUNCTION MakeValidPersonName(sValue VARCHAR2, iStrict PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Возвращает исправленное значение фамилии, имени, отчества. Если sValue is null, возвращает null. Если значение не может быть исправлено, при iStrict!=0 генерируется exception, в противном случае возвращает null.

FUNCTION GetInitialName(sName VARCHAR2, iInsertSpace PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Возвращает инициал части имени вместе с «.». При iInsertSpace<>0 вставляет в начало пробел. Если строка пустая, возвращает null.

FUNCTION GetFullNameWithInitials(sLastName VARCHAR2, sFirstName VARCHAR2, sMiddleName VARCHAR2, iReverseOrder PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Возвращает ФИО в формате «Фамилия И. О.» при iReverseOrder или в формате «И. О. Фамилия» при iReverseOrder!=0.

FUNCTION GetFullNameWithBirthYear(sLastName VARCHAR2, sFirstName VARCHAR2, sMiddleName VARCHAR2, iBirthYear PLS_INTEGER) RETURN VARCHAR2 deterministic;

Возвращает ФИО в формате «Фамилия Имя Отчество, nnnn г.р.».

FUNCTION GetFullPersonName(sLastName VARCHAR2, sFirstName VARCHAR2, sMiddleName VARCHAR2, iSex PLS_INTEGER, dBirthDate DATE, dDeathDate DATE, iMode PLS_INTEGER) RETURN VARCHAR2 deterministic;

Возвращает описание человека.
Способ отображения в зависимости от значения iMode:

• 0 - возвращает [Фамилия Имя Отчество + дата рождения + дата смерти];
  
• 1 - возвращает [Фамилия И. О.];
  
• 2 - возвращает [Фамилия Имя Отчество].

FUNCTION GetSexFromName(sLastName VARCHAR2, sMiddleName VARCHAR2) RETURN PLS_INTEGER;

Определяет пол по фамилии и отчеству. Возвращает:

• 0 - мужской;
  
• 1 - женский;
  
• null - не удалось определить.

FUNCTION GetEquivNameNotations(sName VARCHAR2, iMaxCaseCount PLS_INTEGER) RETURN uszn.TStringList4000;

Возвращает список эквивалентных наименований имени с учётом эквивалентности букв Е и Ё.
Список заполняется в верхнем регистре.
Параметры:

• sName - имя;
  
• iMaxCaseCount - максимальное количество рассматриваемых вариантов; если количество вариантов превышает этот предел, возвращает только iMaxCaseCount из них.

FUNCTION NormalizePersonName(sName VARCHAR2, iNameKind PLS_INTEGER, iStrict PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Нормализует имя (фамилию, отчество) человека: убирает лишние пробелы и разделители.
Параметры:

• sName - значение имени;
  
• iNameKind - вид имени: 1 - фамилия; 2 - имя; 3 - отчество.
  
• iStrict - определяет поведение при наличии в имени недопустимых символов.
  

Возвращает нормализованное имя или null, если имя не содержит ничего, кроме пробелов.

FUNCTION IntegerToWords(iNum INTEGER, iGender PLS_INTEGER) RETURN VARCHAR2 deterministic;

Преобразует число в число прописью.
Параметры:

• iNum - преобразуемое число;
  
• iGender - род: 0 - мужской; 1 - женский; 2 - средний.

FUNCTION OrdinalToWords(iNum PLS_INTEGER, iGender PLS_INTEGER) RETURN VARCHAR2 deterministic;

Преобразует порядковое числительное в текст. Пока поддерживаются только числительные от 0 до 999.
Параметры:

• iNum - преобразуемое число;
  
• iGender - род: 0 - мужской; 1 - женский; 2 - средний.

FUNCTION CurrencyToWords(nCurrency NUMBER) RETURN VARCHAR2 deterministic;

Возвращает сумму прописью в виде: «столько-то руб. 99 коп.».

FUNCTION CurrencyToWordsNum(nCurrency NUMBER, iUseGroupDelims PLS_INTEGER) RETURN VARCHAR2 deterministic;

Возвращает сумму прописью в виде: «nnnnnnnn руб. mm коп.»
Параметры:

• nCurrency - значение в рублях;
  
• iUseGroupDelims - использовать ли разделители групп разрядов (0/1).

FUNCTION MonthName(iMonth PLS_INTEGER, iCase PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Возвращает наименование месяца, iMonth=[1..12]
iCase (падеж):

• 0 - именительный
  
• 1 - родительный.

FUNCTION DateMonthName(d DATE, iCase PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Возвращает наименование месяца из даты, iMonth=[1..12]
iCase (падеж):

• 0 - именительный
  
• 1 - родительный.

FUNCTION DateToSQLExpr(d DATE) RETURN VARCHAR2 deterministic;

Преобразует дату в строку вида ToDate('01.12.2005','dd.mm.yyyy'). Если d=null, возвращает null.

FUNCTION RgnPrefix(iRgnID uszn.tsrv_regions.id%TYPE, iNoZeroRgn PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Возвращает ID района iRgnID в квадратных скобках. Если iNoZeroRgn!=0, то для iRgnID=0 возвращает пустую строку.

FUNCTION StripRgnPrefix(s VARCHAR2) RETURN VARCHAR2;

Возвращает исходную строку без регионального префикса; если префикс в строке отсутствует, она возвращается без изменений.

FUNCTION GetRegionIDFromGUID(rGUID RAW, iStrict PLS_INTEGER) RETURN PLS_INTEGER deterministic;

Извлекает ID района из “районного” GUID версии 1 по RFC 4122. Если GUID ошибочен или содержит код района, выходящий за диапазон 0-999, поведение определяется параметром iStrict.

FUNCTION NounForCount(iCount PLS_INTEGER, sOne VARCHAR2, sSeveral VARCHAR2, sLots VARCHAR2, iZero PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Возвращает существительное в зависимости от числа iCount (например, месяц, месяца, месяцев). Если iZero=0 (по умолчанию 1), то при iCount=0 возвращает null.

FUNCTION CLOBToVarchar(s IN CLOB, iMaxLen PLS_INTEGER := 4000) RETURN VARCHAR2;

Возвращает Varchar2 из CLOB, при необходимости «урезая» его до iMaxLen. При урезании добавляет в конце символ «…» так, что суммарная длина строки получается iMaxLen.

PROCEDURE CLOBAppend(sTarget IN OUT NOCOPY CLOB, sValue VARCHAR2);

Добавляет строку sValue к CLOB.

PROCEDURE BLOBAppend(bTarget IN OUT NOCOPY BLOB, rValue RAW);

Добавляет данные к BLOB.

FUNCTION CLOBToBLOB(cSrc CLOB, sDestCharset VARCHAR2 := NULL) RETURN BLOB;

Преобразует CLOB в BLOB.
Параметры:

• cSrc - исходные данные;
  
• sDestCharset - кодировка, в которой необходимо закодировать данные; по умолчанию сохраняется кодировка в БД.

FUNCTION BLOBToCLOB(bSrc BLOB, sSrcCharset VARCHAR2 := NULL) RETURN CLOB;

Преобразует BLOB в CLOB.
Параметры:

• bSrc - исходные данные;
  
• sSrcCharset - кодировка исходных данных; по умолчанию считается, что кодировка совпадает с кодировкой БД.

FUNCTION BLOBToHex(bSrc BLOB) RETURN CLOB;

Преобразует BLOB в CLOB.
Параметры:

• bSrc - исходные данные;.

FUNCTION FormatNameWithRKey(sName VARCHAR2, iID PLS_INTEGER, iRegionID PLS_INTEGER, iDisplayMode PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Возвращает форматированное наименование sName с ключом region_id-id:
iDisplayMode регулирует способ вывода результата:

• 0 - возвращает sName
  
• 1 - возвращает «sName»
  
• 2 - возвращает region_id-id («sName»)
  
• 3 - возвращает «[RgnPrefix] sName», где RgnPrefix выводится только для районов, отличных от 0
  
• 4 - возвращает [RgnPrefix] sName, где RgnPrefix выводится только для районов, отличных от 0.

FUNCTION DateIntervalToStr(nDelta NUMBER) RETURN VARCHAR2 deterministic;

Возвращает интервал времени в днях в виде текста, например 1 день 3 часа 12 секунд.

FUNCTION DateIntervalToStr(dFrom DATE, dTo DATE, iInitCap PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Возвращает текстовое описание периода в виде «С 01.01.2000 по 01.01.2001». Если iInitCap=0, то первая буква

• делается строчной, иначе - заглавной. Даты (С=01.01.0001) и (По=31.12.9999) отбрасываются.

FUNCTION GetDelimitedStringPart(sString VARCHAR2, sDelimiter VARCHAR2, iPartOrderNum PLS_INTEGER) RETURN VARCHAR2 deterministic;

Разбивает строку по заданному sDelimiter и возвращает указанную её часть.

FUNCTION GetStringListItem(S uszn.TStringList255, iIdx PLS_INTEGER, iStrict PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает указанный элемент переданного списка строк.

FUNCTION ParseIntegerList(sList VARCHAR2) RETURN uszn.TIntegerList;

Получают из списка целых чисел, разделённых запятыми, таблицу целых чисел.

FUNCTION ParseIntegers(sList VARCHAR2) RETURN TIntegers;

FUNCTION ParseRgnKeyList(sList VARCHAR2) RETURN uszn.TRgnKeyList;

Получает из списка region_id*1000000+id, разделённых запятыми, таблицу региональных ключей.

FUNCTION ParseRKeyList(sList VARCHAR2) RETURN uszn.TRgnKeyList;

Получает из списка (region_id,id), разделённых запятыми, таблицу региональных ключей.

FUNCTION ParseRKeyListCLOB(sList IN CLOB) RETURN uszn.TRgnKeyList;

То же, но входной параметр - CLOB.

FUNCTION ParseRKeyListRev(sList VARCHAR2) RETURN uszn.TRgnKeyList;

Получает из списка (id,region_id), разделённых запятыми, таблицу региональных ключей.

FUNCTION SplitDelimitedString(sString VARCHAR2, sDelimiter VARCHAR2) RETURN TStrings255 deterministic;

Разбивает строку по заданному sDelimiter и возвращает все её части в массиве.

FUNCTION SplitDelimitedString4000(sString VARCHAR2, sDelimiter VARCHAR2) RETURN TStrings4000 deterministic;

Аналогична pkGen.SplitDelimitedString, но с другими ограничениями на размер строк.

FUNCTION Str30ListToStr(ssValues IN TStrings30, sDelimiter VARCHAR2 := ',', sQuoteChar VARCHAR2 := '''') RETURN VARCHAR2 deterministic;

Преобразует массив значений Varchar2(30) в строку значений, разделённых разделителем sDelimiter. Если sQuoteChar не null, выполняется квотинг значений, в этом случае значения могут содержать символ разделителя.

FUNCTION Str255ListToStr(ssValues IN TStrings255, sDelimiter VARCHAR2 := ',', sQuoteChar VARCHAR2 := '''') RETURN VARCHAR2 deterministic;

Преобразует массив значений Varchar2(255) в строку значений, разделённых разделителем sDelimiter. Если sQuoteChar не null, выполняется квотинг значений, в этом случае значения могут содержать символ разделителя.

FUNCTION Str4000ListToStr(ssValues IN TStrings4000, sDelimiter VARCHAR2 := ',', sQuoteChar VARCHAR2 := '''') RETURN VARCHAR2 deterministic;

Преобразует массив значений Varchar2(4000) в строку значений, разделённых разделителем sDelimiter. Если sQuoteChar не null, при необходимости выполняется квотинг значений, в этом случае значения могут содержать символ разделителя.

FUNCTION ParseCommaStr4000List(sList VARCHAR2, sDelimiter VARCHAR2 := ',', sQuoteChar VARCHAR2 := '''') RETURN TStrings4000 deterministic;

Получает из списка значений, разделённых разделителем sDelimiter, массив этих значений. Если sQuoteChar не null, выполняется деквотинг значений, в этом случае значения могут содержать символ разделителя.

FUNCTION ParseCrDelimitedStr4000List(sList VARCHAR2) RETURN TStrings4000 deterministic;

Выполняет разбор строковых значений, разделённых переводами строк.

FUNCTION IndexOf(ssValues IN TStrings30, sValue VARCHAR2) RETURN PLS_INTEGER deterministic;

Возвращает индекс sValue в списке ssValues. Если sValue отсутствует в списке, возвращает null.

FUNCTION IndexOf(ssValues IN TStrings255, sValue VARCHAR2) RETURN PLS_INTEGER deterministic;

FUNCTION IndexOf(ssValues IN TStrings4000, sValue VARCHAR2) RETURN PLS_INTEGER deterministic;

FUNCTION MakeRgnIDRec(iID PLS_INTEGER, iRgnID PLS_INTEGER) RETURN TRgnIDRec deterministic;

Преобразует ID и REGION_ID в тип TRgnIDRec.

FUNCTION EncodeIDRgnID(iID PLS_INTEGER, iRgnID PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000) RETURN PLS_INTEGER deterministic;

Кодирует iRgnID*iRgnFactor+iID → Pls_Integer.

FUNCTION EncodeRgnIDRec(RgnIDRec TRgnIDRec, iRgnFactor PLS_INTEGER := 1000000) RETURN PLS_INTEGER deterministic;

Кодирует RgnIDRec → Pls_Integer.

PROCEDURE DecodeIDRgnID(iValue PLS_INTEGER, iID OUT PLS_INTEGER, iRgnID OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000);

Декодирует iValue ← iRgnID*iRgnFactor+iID.

PROCEDURE DecodeRgnIDRec(iValue PLS_INTEGER, RgnIDRec OUT TRgnIDRec, iRgnFactor PLS_INTEGER := 1000000);

Декодирует iValue ← RgnIDRec.

PROCEDURE LockSet(sLockName VARCHAR2, sErrorMessage VARCHAR2, iExclusive PLS_INTEGER, iTimeout INTEGER := 3);

Пытается установить блокировку с именем sLockName. Если это не удалось, вызывается Exception с сообщением sErrorMessage. iExclusive = 1 - если требуется установить эксклюзивную блокировку, 0 - shared-блокировку.

PROCEDURE LockConvert(sLockName VARCHAR2, sErrorMessage VARCHAR2, iExclusive PLS_INTEGER, iSetIfNotExists PLS_INTEGER, iTimeout INTEGER := 3);

Преобразует имеющуюся блокировку в указанную.
Если это не удалось, вызывается Exception.
Параметры:

• sLockName - имя блокировки;
  
• sErrorMessage - сообщение об ошибке, выдаваемое, если требуемую блокировку не удалось получить;
  
• iExclusive - 1 - если требуется получить эксклюзивную блокировку, 0 - shared-блокировку;
  
• iSetIfNotExists - устанавливать ли блокировку, если она ещё не установлена (0/1);
  
• iTimeout - время ожидания в секундах при попытке установить блокировку.

FUNCTION LockIsSet(sLockName VARCHAR2, iExclusive PLS_INTEGER, iTimeout INTEGER := 3) RETURN PLS_INTEGER;

Проверяет наличие установленной блокировки с именем sLockName. Если она установлена, возвращает 1, иначе - 0. iExclusive = 1 - если проверяется наличие эксклюзивной блокировки, 0 - shared-блокировки. Внимание! Если блокировка установлена этой же сессией, то функция не может определить вид установленной блокировки и всегда возвращает 1.

PROCEDURE LockRelease(sLockName VARCHAR2);

Снимает блокировку с именем sLockName.

FUNCTION ExtractFilenameFromFullname(sFullname VARCHAR2) RETURN VARCHAR2 deterministic;

Извлекает filename.ext из /Path/filename.ext или C:\Path\filename.ext.

FUNCTION ExtractPathFromFullname(sFullname VARCHAR2) RETURN VARCHAR2 deterministic;

Извлекает /Path/ из /Path/filename.ext или C:\Path\ из C:\Path\filename.ext.

FUNCTION FileExtractName(sFileName VARCHAR2) RETURN VARCHAR2 deterministic;

Извлекает filename из filename.ext.

FUNCTION FileExtractExt(sFileName VARCHAR2) RETURN VARCHAR2 deterministic;

Извлекает ext из filename.ext.

FUNCTION IsValidDate(s VARCHAR2) RETURN PLS_INTEGER deterministic;

Возвращает 1, если строка s представляет собой дату в формате DD.MM.YYYY, иначе 0.

FUNCTION IsValidInteger(s VARCHAR2) RETURN PLS_INTEGER deterministic;

Возвращает 1, если строка s представляет собой допустимое целое число, иначе 0.

FUNCTION IsValidNumber(s VARCHAR2) RETURN PLS_INTEGER deterministic;

Возвращает 1, если строка s представляет собой допустимое число, иначе 0.

FUNCTION DaysToYears(iDays PLS_INTEGER) RETURN NUMBER;

Преобразует период в днях в годы.

PROCEDURE DaysToYMD(iDaysFrom PLS_INTEGER, iYears IN OUT PLS_INTEGER, iMonths IN OUT PLS_INTEGER, iDays IN OUT PLS_INTEGER);

Преобразует период в днях в годы, месяцы и дни.

FUNCTION YearsToDays(nYears NUMBER) RETURN PLS_INTEGER;

Преобразует период в годах в дни.

PROCEDURE YearsToYMD(nYearsFrom NUMBER, iYears IN OUT PLS_INTEGER, iMonths IN OUT PLS_INTEGER, iDays IN OUT PLS_INTEGER);

Преобразует период в годах в годы, месяцы и дни.

FUNCTION YMDToDays(iYears PLS_INTEGER, iMonths PLS_INTEGER, iDays PLS_INTEGER) RETURN PLS_INTEGER;

Преобразует период в годах, месяцах и днях в дни.

FUNCTION YMDToYears(iYears PLS_INTEGER, iMonths PLS_INTEGER, iDays PLS_INTEGER) RETURN NUMBER;

Преобразует период в годах, месяцах и днях в годы.

PROCEDURE NormalizeYMD(iYears IN OUT PLS_INTEGER, iMonths IN OUT PLS_INTEGER, iDays IN OUT PLS_INTEGER);

Нормализует количество лет, месяцев и дней, чтобы количество дней было меньше 30, а количество месяцев - меньше 12.

PROCEDURE YMDBetweenDates(dDate1 DATE, dDate2 DATE, iYears OUT PLS_INTEGER, iMonths OUT PLS_INTEGER, iDays OUT PLS_INTEGER);

Рассчитывает количество лет, месяцев и дней между двумя датами включительно. Если какая-то из дат - null, она заменяется на текущую системную дату.

PROCEDURE AddDate(d DATE, ds IN OUT NOCOPY TDates);

Добавляет дату к списку дат, если её там нет.

PROCEDURE SortDates(ds IN OUT NOCOPY TDates);

Сортирует список дат: если iMode=0, то по возрастанию, иначе - по убыванию.

FUNCTION GetEffectiveDate(d DATE, ds TDates) RETURN DATE;

Возвращает дату из СОРТИРОВАННОГО списка, максимально близкую к d, но не позже её, или null, если d меньше самой

• первой даты.

FUNCTION GetTruncatedDate(d DATE, iPeriodicity PLS_INTEGER := 1, iAddPeriods PLS_INTEGER := 0, iStrict PLS_INTEGER := 1) RETURN DATE deterministic;

Возвращает дату d, округлённую с учётом периодичности iPeriodicity, к которой прибавлено iAddPeriods периодов;
периодичность задаётся в месяцах;
если d is null, возвращается null;
при возникновении ошибки:

• при iStrict=1 возникает исключение,
  
• в противном случае возвращается либо FirstDate, либо LastDate, в зависимости от знака iAddPeriods.

FUNCTION PrevDaySafe(d DATE) RETURN DATE deterministic;

Возвращают соответственно предыдущий и следующий день. Если d равна 01.01.0001 или 31.12.9999 соответственно, то дата возвращается без изменений.

FUNCTION NextDaySafe(d DATE) RETURN DATE deterministic;

FUNCTION DatesToStr(Dates IN TDates, sDelim VARCHAR2 := ',') RETURN VARCHAR2;

Преобразует список дат в строку, разделённую разделителем sDelim.

FUNCTION DelayToTime(dBasicTime DATE, iDelaySec PLS_INTEGER) RETURN DATE;

Возвращает время, отстоящее от исходного на заданную величину.
Параметры:

• dBasicTime - исходное время;
  
• iDelaySec - задержка от исходного времени в секундах.

FUNCTION MakeWhile(d1 DATE, d2 DATE) RETURN TWhile;

Преобразует две даты в тип TWhile.

FUNCTION MakeWhilePrecedingMonth(d DATE, iMonthCount PLS_INTEGER, iStrict PLS_INTEGER) RETURN TWhile;

Создаёт период продолжительностью iMonthCount месяцев, предшествующий месяцу даты d.
Если указанный период создать невозможно, поведение определяется параметром iStrict:

• при iStrict=0 возвращает: null, если месяц d=01.0001; максимально возможный период, даже если он будет короче требуемого.
  
• при iStrict=1 в указанных ситуациях возникает exception.

FUNCTION UnionWhiles(w1 TWhile, w2 TWhile) RETURN TWhile;

Производит объединение периодов. Если w1=null, то просто копирует w2 в w1.

FUNCTION IntersectWhiles(w1 TWhile, w2 TWhile) RETURN TWhile;

Вычисляет пересечение периодов. Если w1=null, то просто копирует w2 в w1, если w2=null - пересечение пустое.

PROCEDURE ExcludeWhile(w1 TWhile, w2 TWhile, wo1 OUT TWhile, wo2 OUT TWhile);

Исключает период w2 из w1.

PROCEDURE InvertWhile(w TWhile, wo1 OUT TWhile, wo2 OUT TWhile);

Инвертирует период w, разбивая его на два: wo1 и wo2.

FUNCTION IsInWhile(w TWhile, d DATE) RETURN BOOLEAN;

Возвращает, содержится ли дата d в периоде w.

FUNCTION IsWhileEmpty(w TWhile) RETURN BOOLEAN;

Возвращает true, если d1 is null или d2 is null или d2<d1.

FUNCTION WhileToStr(w TWhile) RETURN VARCHAR2 deterministic;

Преобразует период в строку, разделяя даты запятой. Если w.d1=null и/или w.d2=null, то даты заменяются на FirstDate и LastDate соответственно.

FUNCTION WhilesToStr(w IN TWhiles) RETURN VARCHAR2 deterministic;

Преобразует список периодов в строку, разделяя периоды запятой.

PROCEDURE IntersectWhileTables(w1 TWhiles, w2 TWhiles, wResult IN OUT TWhiles);

Находит пересечение периодов двух таблиц и возвращает периоды в wResult.

PROCEDURE SortWhiles(w IN OUT NOCOPY TWhiles, iMode PLS_INTEGER := 0);

Сортирует таблицу периодов по d1, d2. Если iMode=0, то по возрастанию, иначе - по убыванию.

FUNCTION CompareWhiles(w1 TWhile, w2 TWhile) RETURN PLS_INTEGER;

Сравнивает последовательность w1 и w2, возвращая:
-1: w1 < w2
0: w1 пересекается с w2
1: w1 > w2
Проверка на то, что w1 и w2 - непустые, не производится!

PROCEDURE SplitWhile(wIn IN OUT TWhile, wOut IN OUT TWhile, d DATE, bIncluding BOOLEAN);

Разбивает интервал wIn по дате d. Если bIncluding=True, то d включается в wIn, в противном случае - в wOut Проверка на то, что wIn и d - непустые, не производится!

FUNCTION BuildPeriodicWhiles(dDateFrom DATE, dDateTo DATE, iPeriodSize PLS_INTEGER) RETURN TWhiles;

Создаёт и возвращает список периодов с dDateFrom по dDateTo с периодичностью iPeriodSize месяцев. При этом dDateFrom и dDateTo не округляются.

FUNCTION BuildWhilesByControlDates(dDateFrom DATE, dDateTo DATE, ControlDates IN TDates) RETURN TWhiles;

Создаёт и возвращает список периодов с dDateFrom по dDateTo с разбивкой по датам в ControlDates. Даты в ControlDates должны быть отсортированы по возрастанию.

FUNCTION ParseWhiles(sWhiles VARCHAR2) RETURN TWhiles;

Разбирает список периодов в виде «<дата1>,<дата2>,...».

PROCEDURE CheckDate(d DATE);

Проверяет, что дата непустая; при ошибке генерирует исключение.

PROCEDURE CheckWhile(w TWhile);

Проверяет, что диапазон не является пустым и d2>=d1; при ошибке генерирует исключение.

PROCEDURE CheckWhileSequence(w1 TWhile, w2 TWhile);

Проверяет, что диапазоны являются допустимыми и следуют друг за другом; при ошибке генерирует исключение.

FUNCTION GetEmptyWhileRecs RETURN TWhileRecs;

Возвращает связанный список периодов, не содержащий ни одного периода.

FUNCTION GetFullWhileRecs RETURN TWhileRecs;

Возвращает связанный список периодов, содержащий единственный период: FirstDate-LastDate.

FUNCTION MakeWhileRecs(d1 DATE, d2 DATE) RETURN TWhileRecs;

Создаёт связанный список периодов, содержащий один период.

FUNCTION GetNextWhileRec(Whs TWhileRecs, iIndex PLS_INTEGER := NULL) RETURN PLS_INTEGER;

Возвращает следующий элемент связного списка. Если iIndex is null, возвращает первый элемент списка.

FUNCTION GetPrevWhileRec(Whs TWhileRecs, iIndex PLS_INTEGER := NULL) RETURN PLS_INTEGER;

Возвращает предыдущий элемент связного списка. Если iIndex is null, возвращает последний элемент списка.

FUNCTION GetNextWhileCount(Whs TWhileCounts, iIndex PLS_INTEGER := NULL) RETURN PLS_INTEGER;

Возвращает следующий элемент связного списка. Если iIndex is null, возвращает первый элемент списка.

FUNCTION GetPrevWhileCount(Whs TWhileCounts, iIndex PLS_INTEGER := NULL) RETURN PLS_INTEGER;

Возвращает предыдущий элемент связного списка. Если iIndex is null, возвращает последний элемент списка.

FUNCTION InsertWhileAfter(Whs IN OUT NOCOPY TWhileRecs, Wh TWhile, iAfter PLS_INTEGER) RETURN PLS_INTEGER;

Вставляет элемент после элемента с индексом iAfter Если iAfter is null, то новый элемент вставляется в начало списка. Возвращает индекс вновь вставленного элемента.

FUNCTION InsertWhileBefore(Whs IN OUT NOCOPY TWhileRecs, Wh TWhile, iBefore PLS_INTEGER) RETURN PLS_INTEGER;

Вставляет элемент перед элементом с индексом iBefore Если iBefore is null, то новый элемент вставляется в конец списка. Возвращает индекс вновь вставленного элемента.

PROCEDURE DeleteWhile(Whs IN OUT NOCOPY TWhileRecs, iIndex PLS_INTEGER);

Удаляет из связного списка TWhileRecs элемент с индексом iIndex.

FUNCTION InsertWhileCountAfter(Whs IN OUT NOCOPY TWhileCounts, Wh TWhile, iCount PLS_INTEGER, iAfter PLS_INTEGER) RETURN PLS_INTEGER;

Вставляет элемент после элемента с индексом iAfter Если iAfter is null, то новый элемент вставляется в начало списка. Возвращает индекс вновь вставленного элемента.

FUNCTION InsertWhileCountBefore(Whs IN OUT NOCOPY TWhileCounts, Wh TWhile, iCount PLS_INTEGER, iBefore PLS_INTEGER) RETURN PLS_INTEGER;

Вставляет элемент перед элементом с индексом iBefore Если iBefore is null, то новый элемент вставляется в конец списка. Возвращает индекс вновь вставленного элемента.

PROCEDURE DeleteWhileCount(Whs IN OUT NOCOPY TWhileCounts, iIndex PLS_INTEGER);

Удаляет из связного списка TWhileCounts элемент с индексом iIndex.

FUNCTION AddWhileToRecs(Whs IN OUT NOCOPY TWhileRecs, Wh TWhile) RETURN PLS_INTEGER;

Добавляет период Wh в связный список периодов Whs. При необходимости происходит объединение интервалов.

FUNCTION AddWhileToRecs(Whs IN OUT NOCOPY TWhileRecs, d1 DATE, d2 DATE) RETURN PLS_INTEGER;

Версия функции с датами вместо периода.

PROCEDURE AddWhileToCounts(Whs IN OUT NOCOPY TWhileCounts, Wh TWhile);

Добавляет период к списку WhileCounts. При необходимости происходит разбиение интервалов.

FUNCTION SplitWhileCount(Whs IN OUT NOCOPY TWhileCounts, iIndex PLS_INTEGER, d DATE, bIncluding BOOLEAN) RETURN PLS_INTEGER;

Разбивает интервал с индексом iIndex на два интервала по дате d и вставляет второй из них после первого. Если bIncluding=True, то d включается в первый интервал, в противном случае - во второй. Возвращает индекс вновь вставленного интервала или null, если изменения не производились.

PROCEDURE UnionWhileRecs(w1 TWhileRecs, w2 TWhileRecs, wResult IN OUT TWhileRecs);

Находит объединение периодов двух связных списков и возвращает периоды в wResult.

PROCEDURE InvertWhileRecs(w TWhileRecs, wResult IN OUT TWhileRecs);

Вычисляет инверсию w и результат помещает в wResult.

PROCEDURE IntersectWhileRecs(w1 TWhileRecs, w2 TWhileRecs, wResult IN OUT TWhileRecs);

Находит пересечение периодов двух связных списков и возвращает периоды в wResult.

PROCEDURE SubtractWhileRecs(w1 TWhileRecs, w2 TWhileRecs, wResult IN OUT TWhileRecs);

Находит разность w1-w2 и возвращает периоды в wResult.

PROCEDURE AddWhileRecsToWhileCounts(Whs TWhileRecs, WhileCounts IN OUT NOCOPY TWhileCounts);

Добавляет список периодов к списку WhileCounts.

PROCEDURE AddWhileCountsToWhileRecs(WhileCounts TWhileCounts, Whs IN OUT NOCOPY TWhileRecs, iValue PLS_INTEGER, iCondition PLS_INTEGER := 0);

Добавляет интервалы из WhileCounts, удовлетворяющие условию, к списку интервалов. При необходимости происходит объединение интервалов.
Условия:
-1: iCount != iValue
0: iCount = iValue (по умолчанию)
1: iCount < iValue
2: iCount ⇐ iValue
3: iCount > iValue
4: iCount >= iValue.

FUNCTION WhileRecsToStr(Whs TWhileRecs, sDelim VARCHAR2 := ',') RETURN VARCHAR2;

Преобразует список периодов в строку, разделяя даты запятой.

FUNCTION WhileCountsToStr(Whs TWhileCounts, sDelim VARCHAR2 := ',') RETURN VARCHAR2;

Преобразует список TWhileCounts в строку.

FUNCTION GetWhileRecsLength(Whs TWhileRecs) RETURN NUMBER;

Возвращает суммарную длину периодов в списке в днях. Если список периодов пуст, возвращает 0.

FUNCTION GetPeriodPartValue(dDateFrom DATE, dDateTo DATE, wwIncludedWhileRecs IN TWhileRecs, wwExcludedWhileRecs IN TWhileRecs, iIgnoreEmptyIncludedRecs PLS_INTEGER) RETURN NUMBER;

Возвращает долю периодов wwIncludedWhileRecs за вычетом периодов wwExcludedWhileRecs в периоде dDateFrom-dDateTo. Учитывается только та часть периодов wwIncludedWhileRecs, которая лежит в пределах периода dDateFrom-dDateTo.

FUNCTION GetDateForTermReached(Periods IN TWhileRecs, nRequiredYears NUMBER) RETURN DATE;

Возвращает для списка периодов дату, на которую накапливается период заданной продолжительности.

FUNCTION RawToGUIDStr(rGUID RAW, iAddBrackets PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Преобразует GUID, представленный в виде RAW-значения, в строку GUID вида {xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx}.
Параметры:

• rGUID - значение GUID;
  
• iIncludeBrackets - добавлять ли к выходному значению скобки ”{” и ”}” (0/1).
  

При обнаружении ошибки в значении rRaw вызывает exception.

FUNCTION CompareIntegers(i1 PLS_INTEGER, i2 PLS_INTEGER, iNullsLast PLS_INTEGER := 1) RETURN PLS_INTEGER deterministic;

Сравнивает два целых на больше/меньше. Возвращает отрицательное число, если i1<i2, 0, если i1=i2, положительное число, если i1>i2. При iNullsLast=0 null считается меньше любого числа, иначе больше любого числа; null=null.

FUNCTION CompareDates(d1 DATE, d2 DATE, iNullsLast PLS_INTEGER := 1) RETURN PLS_INTEGER deterministic;

Сравнивает две даты на больше/меньше. Возвращает отрицательное число, если d1<d2, 0, если d1=d2, положительное число, если d1>d2. При iNullsLast=0 null считается меньше любого числа, иначе больше любого числа; null=null.

FUNCTION CompareNumbers(n1 NUMBER, n2 NUMBER, iNullsLast PLS_INTEGER := 1) RETURN PLS_INTEGER deterministic;

Сравнивает два вещественных числа на больше/меньше. Возвращает отрицательное число, если n1<n2, 0, если n1=n2, положительное число, если n1>n2. При iNullsLast=0 null считается меньше любого числа, иначе больше любого числа; null=null.

FUNCTION CompareStrings(s1 VARCHAR2, s2 VARCHAR2, iNullsLast PLS_INTEGER := 1) RETURN PLS_INTEGER deterministic;

Сравнивает два строковых значения на больше/меньше. Возвращает отрицательное число, если s1<s2, 0, если s1=s2, положительное число, если s1>s2. При iNullsLast=0 null считается меньше любого числа, иначе больше любого числа; null=null.

FUNCTION TruncToNSec(d DATE, N PLS_INTEGER) RETURN DATE deterministic;

Усекает количество секунд в дате до ближайшего меньшего числа, кратного N.

FUNCTION DaysInMonth(d DATE) RETURN NUMBER deterministic;

Возвращает количество дней в текущем месяце даты.

FUNCTION GetLastNumberForGlobalSeq(iGSQID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает последний ID записи из таблицы для указанной глобальной последовательности.

FUNCTION GetLastNumberForRgnSeq(iRSQID PLS_INTEGER, iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает последний ID записи из таблицы для указанной региональной последовательности.

FUNCTION GetGlobalSeqID(sSequenceName VARCHAR2) RETURN PLS_INTEGER;

Возвращает следующее значение глобальной последовательности.

FUNCTION GetRgnSeqID(iRegionID PLS_INTEGER, sSeqNameSuffix VARCHAR2) RETURN PLS_INTEGER;

Возвращает следующее значение региональной последовательности с суффиксом sSeqNameSuffix.

FUNCTION GetRgnSeqIDs(iRegionID PLS_INTEGER, sSeqNameSuffix VARCHAR2, iCount PLS_INTEGER, sSrcTable VARCHAR2 := 'u_dummy') RETURN TIntegers;

Возвращает массив из iCount следующих значений региональной SEQUENCE с суффиксом sSeqNameSuffix вида 'rpdi_id'

• iRegionID - регион
  
• sSeqNameSuffix - суффикс последовательности
  
• iCount - необходимое количество значений
  
• sSrcTable - таблица, содержащая достаточное количество строк.

FUNCTION GetFreeID(sTableName VARCHAR2, iRegionID PLS_INTEGER := NULL, sRegionIDField VARCHAR2 := 'region_id') RETURN PLS_INTEGER;

Возвращает следующее свободное значение поля id указанной таблицы. Если iRegionID<>null, ищет только в пределах

• района (sRegionIDField - имя поля района).

FUNCTION GetUniqueValueStr(sValue VARCHAR2, sTableName VARCHAR2, sColumn VARCHAR2, sWhere VARCHAR2, sDupePrefix VARCHAR2 := 'Копия', iForcePrefix PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает уникальное строковое значение для столбца sColumn таблицы sTable, беря за основу значение sValue. Если такое значение уже существует, к нему добавляется префикс sDupePrefix. Если такое значение также существует, после префикса добавляется строка « #nn», где nn - целое число>1, которое подбирается последовательно до получения уникального значения. sWhere - условие, накладываемое на таблицу (может отсутствовать). Если iForcePrefix!=0, то префикс sDupePrefix добавляется, даже если значение sValue в таблице изначально отсутствует.

FUNCTION FormatUDCMFields(sUserCreated VARCHAR2, sUserModified VARCHAR2, dCreated DATE, dModified DATE) RETURN VARCHAR2 deterministic;

Форматирует и возвращает на основе полей user/date_created/modified одну строку последнего изменения записи вида

• «USER, 01.01.0001 00:00».

FUNCTION FormatUserDate(sUser VARCHAR2, dDate DATE) RETURN VARCHAR2 deterministic;

Форматирует и возвращает на основе имени пользователя и даты строку вида «USER, 01.01.0001 00:00» (например, для информации о создании или изменении записи БД).

FUNCTION IntegerListToStr(Ints IN uszn.TIntegerList, sDelim VARCHAR2 := ',') RETURN VARCHAR2;

Преобразует список целых чисел в строку, разделённую разделителем sDelim.

FUNCTION IntegersToStr(Ints IN TIntegers, sDelim VARCHAR2 := ',') RETURN VARCHAR2;

Преобразует список целых чисел в строку, разделённую разделителем sDelim.

FUNCTION EnumIntegers(ii TIntegers) RETURN TIntegers;

Возвращает список индексов элементов списка.

PROCEDURE IntegersToIntegerSet(Source IN TIntegers, Result IN OUT NOCOPY TIntegers);

Преобразует список целых чисел в набор целых чисел, где индекс=значение элемента исходного списка, значение=1.

FUNCTION DatesToIntegerSet(Dates IN TDates) RETURN TIntegers;

Преобразует список дат в набор целых чисел, где индекс=дата-01.01.0001, значение=1.

FUNCTION IntegerSetToDates(Ints IN TIntegers, iSortAscending PLS_INTEGER := 1) RETURN TDates;

Преобразует набор целых чисел, где индекс=дата-01.01.0001 (значение игнорируется), в отсортированный список дат.

FUNCTION StrToNamedStringValues(sStr VARCHAR2, sDelimiter VARCHAR2 := NULL, sQuoteChar VARCHAR2 := NULL) RETURN uszn.TNamedStringValueList deterministic;

Перевод текста в список параметров в виде пар name=value. Пары разделяются sDelimiter или переводом строки (Windows или Linux), если sDelimiter не задан. Если задан sQuoteChar, текст пары name=value деквотируется.

FUNCTION NamedStringValuesToStr(List uszn.TNamedStringValueList, sDelimiter VARCHAR2 := CHR(10), sQuoteChar VARCHAR2 := NULL) RETURN VARCHAR2 deterministic;

Перевод списка параметров в текстовый вид в виде пар name=value. Пары разделяются заданным символом-разделителем. Если задан sQuoteChar, текст пары name=value квотируется.

FUNCTION GetNamedStringValueIdx(List uszn.TNamedStringValueList, sName VARCHAR2, iStrict PLS_INTEGER) RETURN PLS_INTEGER deterministic;

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

• List - список имеющихся параметров;
  
• sName - имя искомого параметра;
  
• iStrict - определяет поведение при отсутствии в списке параметра с таким именем.

FUNCTION GetNamedStringValue(List uszn.TNamedStringValueList, sName VARCHAR2, iStrict PLS_INTEGER) RETURN VARCHAR2 deterministic;

Возвращает значение параметра по его имени в списке.
Параметры:

• List - список имеющихся параметров;
  
• sName - имя искомого параметра;
  
• iStrict - определяет поведение при отсутствии в списке параметра с таким именем.
  

Если параметр в списке имеется, но его значение пустое, возвращает null.

PROCEDURE SetNamedStringValue(List IN OUT NOCOPY uszn.TNamedStringValueList, sName VARCHAR2, sValue VARCHAR2);

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

• List - список имеющихся параметров;
  
• sName - имя изменяемого параметра;
  
• sValue - значение изменяемого параметра.
  

Если параметр в списке есть, его значение заменяется на новое. Если параметра в списке нет, он добавляется.
Пустое значение (null) также считается значением, удаление параметра из списка не производится. Для удаления
параметра из списка используется pkGen.DeleteNamedStringValue.

PROCEDURE DeleteNamedStringValue(List IN OUT NOCOPY uszn.TNamedStringValueList, sName VARCHAR2);

Удаляет значение параметра из списка, если оно там имеется.
Параметры:

• List - список имеющихся параметров;
  
• sName - имя удаляемого параметра.
  

Если параметр в списке отсутствует, ничего не происходит.
При удалении параметра в списке появляется “дырка”.

PROCEDURE BubbleSort(ii IN OUT NOCOPY TIntegers);

Сортирует список пузырьковым методом.

PROCEDURE BubbleSort(ss IN OUT NOCOPY TStrings255);