TEXTVALID (Transact-SQL)

特定のテキスト ポインターが有効であるかどうかを確認する、text、ntext、または image 型の関数です。

重要な注意事項重要

この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。代替機能を使用することはできません。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

TEXTVALID ( 'table.column' ,text_ ptr )

引数

  • table
    使用するテーブルの名前です。

  • column
    使用する列の名前です。

  • text_ptr
    確認するテキスト ポインターです。

戻り値の型

int

説明

ポインターが有効なら 1 を、ポインターが無効なら 0 を返します。 text 列の識別子には、テーブル名を含む必要があることに注意してください。 有効なテキスト ポインターがないと、UPDATETEXT、WRITETEXT、READTEXT は使用できません。

次の関数とステートメントは、text、ntext、および image データを操作する場合にも役立ちます。

関数またはステートメント

説明

PATINDEX('%pattern%' , expression)

text および ntext 列で指定された文字列の文字位置を返します。

DATALENGTH(expression)

text、ntext、および image 列内のデータの長さを返します。

SET TEXTSIZE

SELECT ステートメントで返される text、ntext、または image データの制限値をバイト単位で返します。

使用例

次の例では、pub_info テーブルの logo 列の各値に対して、有効なテキスト ポインターが存在するかどうかを報告します。

注意

この例を実行するには、pubs データベースをインストールする必要があります。

USE pubs;
GO
SELECT pub_id, 'Valid (if 1) Text data' 
   = TEXTVALID ('pub_info.logo', TEXTPTR(logo)) 
FROM pub_info
ORDER BY pub_id;
GO

以下に結果セットを示します。

pub_id Valid (if 1) Text data 
------ ---------------------- 
0736   1                      
0877   1                      
1389   1                      
1622   1                      
1756   1                      
9901   1                      
9952   1                      
9999   1                      

(8 row(s) affected)

関連項目

参照

DATALENGTH (Transact-SQL)

PATINDEX (Transact-SQL)

SET TEXTSIZE (Transact-SQL)

テキスト関数とイメージ関数 (Transact-SQL)

TEXTPTR (Transact-SQL)