Funciones de texto e imagen - TEXTVALID (Transact-SQL)

Artículo
01/02/2025

Se aplica a: SQL Server Azure SQL Managed Instance

Una función de tipo text, ntext o image que comprueba la validez de un puntero de texto específico.

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. No hay ninguna funcionalidad alternativa disponible.

Convenciones de sintaxis de Transact-SQL

Sintaxis

TEXTVALID ( 'table.column' ,text_ ptr )

Argumentos

table
Es el nombre de la tabla que se va a utilizar.

column
Es el nombre de la columna que se va a utilizar.

text_ptr
Es el puntero de texto que se va a comprobar.

Tipos de valor devuelto

int

Observaciones

Devuelve 1 si el puntero es válido y 0 si no lo es. Observe que el identificador de la columna de tipo text debe incluir el nombre de la tabla. No es posible utilizar UPDATETEXT, WRITETEXT o READTEXT sin un puntero de texto válido.

Estas funciones e instrucciones son también útiles cuando se trabaja con datos de tipo text, ntext e image.

Función o instrucción	Descripción
PATINDEX ( ' %patrón%* '* , expresión )	Devuelve la posición de carácter de una cadena de caracteres especificada en columnas de tipo text y ntext.
DATALENGTH ( expresión )	Devuelve la longitud de datos en columnas text, ntext e image.
SET TEXTSIZE	Devuelve el límite en bytes de los datos de tipo text, ntext o image que se devuelven con una instrucción SELECT.

Ejemplos

En el siguiente ejemplo se informa acerca de si existe un puntero de texto válido para cada valor de la columna logo de la tabla pub_info.

Nota:

Para ejecutar este ejemplo, debe instalar la base de datos 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

Este es el 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)

Consulte también

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Funciones de texto e imagen (Transact-SQL)
TEXTPTR (Transact-SQL)

Compartir vía