функция substring (XQuery)
Возвращает часть строки, определенной аргументом $sourceString, начиная с позиции, указанной в аргументе $startingLoc, длиной, указанной в аргументе $length.
Синтаксис
fn:substring($sourceString as xs:string?,
$startingLoc as as xs:decimal?) as xs:string?
fn:substring($sourceString as xs:string?,
$startingLoc as xs:decimal?,
$length as xs:decimal?) as xs:string?
Аргументы
$sourceString
Исходная строка.$startingLoc
Начальная позиция в исходной строке, с которой начинается подстрока. Если это значение отрицательно или равно нулю, символы возвращаются с начала строки. Если это значение превышает длину строки, указанной в аргументе $sourceString, возвращается строка нулевой длины.$length
Количество получаемых символов [дополнительно]. Если этот аргумент не указан, возвращаются все символы, начиная с позиции, указанной в аргументе $startingLoc, до конца строки.
Замечания
Версия этой функции с тремя аргументами возвращает символы строки $sourceString, позиции которых $p удовлетворяют следующим условиям:
fn:round($startingLoc) <= $p < fn:round($startingLoc) + fn:round($length)
Значение аргумента $length может превосходить количество символов в строке, определенной аргументом $sourceString. В этом случае подстрока возвращает символы до конца строки $sourceString.
Первый символ строки расположен в позиции 1.
Если значение $sourceString является пустой последовательностью, оно обрабатывается, как строка нулевой длины. Однако если пустой последовательностью является аргумент $startingLoc или $length, возвращается пустая последовательность.
Примеры
В этом разделе представлены примеры XQuery-запросов к экземплярам XML-данных, хранящимся в различных столбцах типа xml в базе данных База данных AdventureWorks2008R2. Обзор каждого из этих столбцов см. в разделе Представление типов данных XML в базе данных AdventureWorks2008R2.
А. Использование функции языка XQuery substring() для получения частичной сводки о модели продукта
Этот запрос получает первые 50 символов строки, описывающей модель продукта, элемент <Summary> документа.
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
SELECT ProductModelID, CatalogDescription.query('
<Prod>{ substring(string((/pd:ProductDescription/pd:Summary)[1]), 1, 50) }</Prod>
') as Result
FROM Production.ProductModel
where CatalogDescription.exist('/pd:ProductDescription') = 1;
В приведенном запросе обратите внимание на следующие моменты.
Функция string() возвращает строковое значение элемента <Summary>. Эту функцию необходимо использовать, потому что элемент <Summary> содержит как текст, так и вложенные элементы (элементы в формате html), которые нужно пропустить и вернуть весь текст.
Функция substring() возвращает первые 50 символов из строкового значения, получаемого функцией string().
Частичный результат:
ProductModelID Result
-------------- -----------------------------------------
19 <Prod>Our top-of-the-line competition mountain bike.</Prod>
23 <Prod>Suitable for any type of riding, on or off-roa</Prod>
...
Ограничения реализации
Существуют следующие ограничения.
SQL Server требует, чтобы аргументы $startingLoc и $length parameters имели тип xs:decimal, а не xs:double.
SQL Server позволяет указывать в качестве аргументов $startingLoc и $length пустую последовательность, потому что пустая последовательность может быть результатом сопоставления динамических ошибок с ().
Суррогатные пары Юникода UTF-16 считаются за два символа, а не за один.