apps-script-utils (Français) 2.1.1 Help

getByteSize

function getByteSize(value: string): number;

Lisez la réserve avant d'utiliser ceci. Le nom et l'intention d'origine visent la longueur en octets UTF-8, mais en l'état la fonction compte des unités de code UTF-16 et n'élargit que le premier substitut rencontré. Pour de l'ASCII, la mesure est juste ; pour le reste — cyrillique, grec, CJK, emoji — elle est sous-évaluée. En attendant un correctif, mesurez avec Utilities.newBlob(text).getBytes().length.

Paramètres

Paramètre

Type

Description

value

string

La chaîne à mesurer.

Valeur de retour

number — la longueur, en unités de code.

Exceptions

Exception

Condition

InvalidStringException

la valeur n'est pas une chaîne.

Exemples

Utilisation

getByteSize("abc"); // => 3

Voir aussi

Code source

src/appsscript/base/getByteSize.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.