StringByteLength

Descripción

Devuelve la cantidad de bytes de una cadena de caracteres para un conjunto de caracteres dado. En ocasiones es útil saber la cantidad de bytes que se necesitan para representar una cadena de caracteres con conjuntos de caracteres multibyte (por ejemplo: UTF-8 o WindowsJapanese). Una cadena de caracteres con un conjunto de caracteres UTF-8 puede usar hasta 4 bytes para representar un carácter.

Sintaxis

StringByteLength ( str,charset)

Argumentos

str es una expresión de cadena de caracteres

charset es una cadena que representa un conjunto de caracteres (MapBasic o Java)

Ambos argumentos son obligatorios.

Ejemplo

Devuelve 32 porque los ocho caracteres japoneses usan cuatro bytes cada uno cuando se usa un protocolo UTF-32.

select StringByteLength("滋賀県草津市草津", "UTF-32")

Comentarios

Si se pasa un valor distinto de una cadena de caracteres para str o charset, se produce un error.

Si se pasa un conjunto de caracteres no válido (incluida una cadena de caracteres vacía) para charset, se produce un error.