文字列値に使用する関数 - upper-case

適用対象:SQL Server

この関数は、 $arg の各文字を大文字に変換します。 Unicode コード ポイントの Microsoft Windows バイナリ ケース変換では、文字を大文字に変換する方法を指定します。 この標準は、Unicode 標準コード ポイント標準のマッピングとは異なります。

構文

  
fn:upper-case($arg as xs:string?) as xs:string  

引数

項目 定義
$arg 大文字に変換する文字列値。

解説

$argの値が空の場合は、長さ 0 の文字列が返されます。

A. 文字列を大文字に変更する

次の例では、入力文字列 'abcDEF!@4' を大文字に変更します。

DECLARE @x xml = N'abcDEF!@4';  
SELECT @x.value('fn:upper-case(/text()[1])', 'nvarchar(10)');  

B. 特定の文字列を検索する

この例では、upper-case 関数を使用して、大文字と小文字を区別せずに検索を行う方法を示しています。

USE AdventureWorks2022;
GO  
--WITH XMLNAMESPACES clause specifies the namespace prefix  
--to use.   
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)  
--The XQuery contains() function is used to determine whether  
--any of the text nodes below the <Summary> element contain  
--the word 'frame'. The upper-case() function is used to make  
--the search case-insensitive.  
  
SELECT ProductModelID, CatalogDescription.query('  
      <Prod>  
         { /pd:ProductDescription/@ProductModelID }  
         { /pd:ProductDescription/pd:Summary }  
      </Prod>  
 ') as Result  
FROM Production.ProductModel  
where CatalogDescription.exist('  
/pd:ProductDescription/pd:Summary//text()[  
          contains(upper-case(.), "FRAME")]')  = 1  

結果セットは次のようになります。

ProductModelID Result

-------------- ---------

19 <Prod ProductModelID="19">

<pd:Summary xmlns:pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">Our top-of-the-line competition mountain bike.

Performance-enhancing options include the innovative HL Frame,

super-smooth front suspension, and traction for all terrain.

</p1:p>

</pd:Summary>

</Prod>

25 <Prod ProductModelID="25">

<pd:Summary xmlns:pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">This bike is ridden by race winners. Developed with the

Adventure Works Cycles professional race team, it has a extremely light

heat-treated aluminum frame, and steering that allows precision control.

</p1:p>

</pd:Summary>

</Prod>

参照

xml データ型に対する XQuery 関数