Compartilhar via

Funções de texto e imagem – TEXTVALID (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Uma função text, ntext ou image que verifica se um ponteiro de texto específico é válido.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. A funcionalidade alternativa não está disponível.

Convenções de sintaxe de Transact-SQL

Sintaxe

TEXTVALID ( 'table.column' ,text_ ptr )

Argumentos

table
É o nome da tabela que será usada.

column
É o nome da coluna que será usada.

text_ptr
É o ponteiro de texto a ser verificado.

Tipos de retorno

int

Comentários

Retorna 1 se o ponteiro for válido e 0 se o ponteiro não for válido. Observe que o identificador para a coluna text deve incluir o nome da tabela. Não é possível usar UPDATETEXT, WRITETEXT ou READTEXT sem um ponteiro de texto válido.

As seguintes funções e instruções também são úteis quando você trabalha com os dados text, ntext e image.

Função ou instrução Descrição
PATINDEX ( ' %pattern% ' , expressão ) Retorna a posição de caractere de uma cadeia de caracteres especificada nas colunas text e ntext.
DATALENGTH ( expressão ) Retorna o comprimento dos dados nas colunas text, ntext e image.
SET TEXTSIZE Retorna o limite, em bytes, dos dados text, ntext ou image a serem retornados com uma instrução SELECT.

Exemplos

O exemplo a seguir informa se um ponteiro de texto válido existe para cada valor na coluna logo da tabela pub_info.

Observação

Para executar este exemplo, é necessário instalar o banco de dados 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

Veja a seguir o conjunto de resultados.

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)

Confira também

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Funções de texto e imagem (Transact-SQL)
TEXTPTR (Transact-SQL)