API len fr

len

API · BASIC

Русский · English · Українська · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

ASC · Chr · len · StrComp

ClassicUO • Runtime API

Vérifie la longueur d’un texte ou de la représentation textuelle d’un nombre.

Syntaxe exacte

len(value:Decimal) -> Integer
len(value:Integer) -> Integer
len(value:String) -> Integer

Paramètres

• value — String, Integer ou Decimal. Format numérique indépendant de la langue, signe moins et point compris.

Retour

Integer : nombre d’unités UTF-16, 0 pour texte vide. Un emoji peut compter pour 2 ; les marques combinées comptent séparément. Pour un nombre, longueur du texte et non taille mémoire. Pour Array, utiliser GetArrayLength.

Comportement

• Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de script, déplacement d’objet ni contact serveur.
• Ne compte ni octets, ni pixels, ni glyphes. Une coupure peut séparer une paire de substituts ; l’exemple d’abréviation utilise ASCII.

Fonctions internes : de l’appel au résultat

String lit Length ; les nombres sont d’abord formatés de manière invariante. L’entrée reste intacte.

1. InternalSubrutines.Len

String lit Length ; les nombres sont d’abord formatés de manière invariante. L’entrée reste intacte.

Integer : nombre d’unités UTF-16, 0 pour texte vide. Un emoji peut compter pour 2 ; les marques combinées comptent séparément. Pour un nombre, longueur du texte et non taille mémoire. Pour Array, utiliser GetArrayLength.

Source du projet: external/InjectionScript/src/InjectionScript/Runtime/InternalSubrutines.cs; fonction InternalSubrutines.Len.

Ne compte ni octets, ni pixels, ni glyphes. Une coupure peut séparer une paire de substituts ; l’exemple d’abréviation utilise ASCII.

Exemples

Abréger une étiquette

# Abréger une étiquette
#
# Vérifie la longueur d’un texte ou de la représentation textuelle d’un nombre.
#
# Integer : nombre d’unités UTF-16, 0 pour texte vide. Un emoji peut compter pour 2 ; les
# marques combinées comptent séparément. Pour un nombre, longueur du texte et non taille
# mémoire. Pour Array, utiliser GetArrayLength.

SUB Main()
    # Cinq lettres ASCII et trois points donnent LongC..., longueur 8.
    # Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de
    # script, déplacement d’objet ni contact serveur.

    Dim label = "LongCharacterName"
    If Len(label) > 8 Then
        Return Left(label, 5) & "..."
    End If
    Return label
END SUB

Explication des paramètres et du déroulement:

• Cinq lettres ASCII et trois points donnent LongC..., longueur 8.
• Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de script, déplacement d’objet ni contact serveur.

Rejeter une valeur vide

# Rejeter une valeur vide
#
# Vérifie la longueur d’un texte ou de la représentation textuelle d’un nombre.
#
# Integer : nombre d’unités UTF-16, 0 pour texte vide. Un emoji peut compter pour 2 ; les
# marques combinées comptent séparément. Pour un nombre, longueur du texte et non taille
# mémoire. Pour Array, utiliser GetArrayLength.

SUB Main()
    # Trim supprime les espaces, Len donne 0, Main renvoie missing.
    # Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de
    # script, déplacement d’objet ni contact serveur.

    Dim setting = Trim("   ")
    If Len(setting) = 0 Then
        Return "missing"
    End If
    Return setting
END SUB

Explication des paramètres et du déroulement:

• Trim supprime les espaces, Len donne 0, Main renvoie missing.
• Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de script, déplacement d’objet ni contact serveur.

Comparer deux longueurs

# Comparer deux longueurs
#
# Vérifie la longueur d’un texte ou de la représentation textuelle d’un nombre.
#
# Integer : nombre d’unités UTF-16, 0 pour texte vide. Un emoji peut compter pour 2 ; les
# marques combinées comptent séparément. Pour un nombre, longueur du texte et non taille
# mémoire. Pour Array, utiliser GetArrayLength.

SUB Main()
    # Emoji : 2 ; texte -125 avec son signe : 4. Résultat 2|4.
    # Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de
    # script, déplacement d’objet ni contact serveur.

    Dim symbol = Chr(0x1F600)
    Dim quantity = -125
    Return CStr(Len(symbol)) & "|" & CStr(Len(quantity))
END SUB

Explication des paramètres et du déroulement:

• Emoji : 2 ; texte -125 avec son signe : 4. Résultat 2|4.
• Traitement local de données d’exemple avec valeur de retour. Aucun message envoyé, arrêt de script, déplacement d’objet ni contact serveur.