• 發行項

number 函數 (XQuery)

傳回 $arg 所指出的節點數值。

語法

fn:number() as xs:double? 
fn:number($arg as node()?) as xs:double?

引數

  • $arg
    節點值將以數字傳回。

備註

如果未指定 $arg，就會傳回轉換為雙精度浮點數的內容節點數值。在 SQL Server 中，沒有引數的 fn:number() 只能用於內容相依述詞的內容中。具體而言，它只能在括號 ([ ]) 內使用。例如，下列運算式會傳回 <ROOT> 元素。

declare @x xml
set @x='<ROOT>111</ROOT>'
select @x.query('/ROOT[number()=111]')

如果節點的值不是數值簡單類型的有效語彙表示，如＜XML 結構描述第 2 部份：資料類型、W3C 建議＞中所定義，函數會傳回空白時序。不支援 NaN。

範例

本主題是針對 XML 執行個體提供 XQuery 範例，這些執行個體是儲存在 AdventureWorks 資料庫的各個 xml 類型的資料行中。如需這些資料行中每個資料行的概觀，請參閱＜在 AdventureWorks 資料庫中的 xml 資料類型表示法＞。

A. 使用 number() XQuery 函數擷取屬性的數值。

下列查詢會從第一個工作中心位置的製造產品型號 7 之過程中，擷取配置大小屬性的數值。

SELECT ProductModelID, Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions" ;
     for $i in (//AWMI:root//AWMI:Location)[1]
     return 
       <Location LocationID="{ ($i/@LocationID) }" 
                   LotSizeA="{  $i/@LotSize }"
                   LotSizeB="{  number($i/@LotSize) }"
                   LotSizeC="{ number($i/@LotSize) + 1 }" >
                   
       </Location>
') as Result
FROM Production.ProductModel
WHERE ProductModelID=7

請注意下列項目是從上一個查詢而來：

  • 不需要 number() 函數，如 LotSizeA 屬性的查詢所示。這是 XPath 1.0 函數，主要是基於回溯相容性而包含它。

  • LotSizeB 的 XQuery 會指定 number 函數，所以是多餘的。

  • LotSizeD 的查詢說明算術運算中數值的使用。

以下是結果：

ProductModelID   Result
----------------------------------------------
7              <Location LocationID="10" 
                         LotSizeA="100" 
                         LotSizeB="100" 
                         LotSizeC="101" />

實作限制

以下為其限制：

  • number() 函數只接受節點。它不接受不可部份完成值。

  • 當值無法以數字傳回時，number() 函數會傳回空白時序而不是 NaN。