Поделиться через


функция 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, которые хранятся в базе данных AdventureWorks в различных столбцах типа XML. Обзор каждого из этих столбцов см. в разделе Представление типов XML-данных в базе данных AdventureWorks.

А. Использование функции языка 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 считаются за два символа, а не за один.

См. также

Справочник