DATALENGTH (Transact-SQL)

Retourne le nombre d'octets utilisés pour représenter une expression.

Conventions de la syntaxe de Transact-SQL

Syntaxe

DATALENGTH ( expression ) 

Arguments

expression

Expression de n'importe quel type de données.

Notes

DATALENGTH est particulièrement utile pour les types de données varchar, varbinary, text, image, nvarchar et ntext, car ces types de données permettent le stockage des données de longueur variable.

La fonction DATALENGTH exécutée sur la valeur NULL donne NULL comme résultat.

Remarque :
Les niveaux de compatibilité peuvent affecter les valeurs retournées. Pour plus d'informations sur les niveaux de compatibilité, consultez sp_dbcmptlevel (Transact-SQL)

Type des valeurs retournées

bigint si expression est du type varchar(max), nvarchar(max) ou varbinary(max) ; sinon int.

Exemple

Cet exemple trouve la longueur de la colonne Name dans la table Product.

USE AdventureWorks;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO

Voir aussi

Référence

LEN (Transact-SQL)
CAST et CONVERT (Transact-SQL)
Types de données (Transact-SQL)
Fonctions système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005