API Chr fr

Chr

API · BASIC

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

ASC · Chr · len · StrComp

ClassicUO • Runtime API

Crée un caractère Unicode ou de contrôle pour composer du texte.

Syntaxe exacte

Chr(value:Integer) -> String

Paramètres

• value — Code Integer limité à 0..0x10FFFF. Les substituts 0xD800..0xDFFF déclenchent une erreur interceptable.

Retour

String d’une ou deux unités UTF-16. Chr(0) contient NUL, pas une chaîne vide. Un emoji prend deux unités ; ASC ne retrouve pas son code complet.

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.
• Integer requis, pas de Decimal direct. Tabulations et sauts de ligne sont des caractères, pas des touches ; leur affichage dépend du composant destinataire.

Fonctions internes : de l’appel au résultat

BasicChr limite le code et appelle ConvertFromUtf32 ; un code valide supérieur à 0xFFFF produit une paire de substituts.

1. BasicChr / Char.ConvertFromUtf32

BasicChr limite le code et appelle ConvertFromUtf32 ; un code valide supérieur à 0xFFFF produit une paire de substituts.

String d’une ou deux unités UTF-16. Chr(0) contient NUL, pas une chaîne vide. Un emoji prend deux unités ; ASC ne retrouve pas son code complet.

Source du projet: external/InjectionScript/src/InjectionScript/Runtime/InjectionApi.cs; fonction BasicChr / Char.ConvertFromUtf32.

Integer requis, pas de Decimal direct. Tabulations et sauts de ligne sont des caractères, pas des touches ; leur affichage dépend du composant destinataire.

Exemples

Préparer un enregistrement

# Préparer un enregistrement
#
# Crée un caractère Unicode ou de contrôle pour composer du texte.
#
# String d’une ou deux unités UTF-16. Chr(0) contient NUL, pas une chaîne vide. Un emoji prend
# deux unités ; ASC ne retrouve pas son code complet.

SUB Main()
    # Chr(9) sépare ore et 50 par une tabulation : ore<TAB>50.
    # 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 resource = "ore"
    Dim amount = 50
    Return resource & Chr(9) & CStr(amount)
END SUB

Explication des paramètres et du déroulement:

• Chr(9) sépare ore et 50 par une tabulation : ore50.
• 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.

Préparer deux lignes

# Préparer deux lignes
#
# Crée un caractère Unicode ou de contrôle pour composer du texte.
#
# String d’une ou deux unités UTF-16. Chr(0) contient NUL, pas une chaîne vide. Un emoji prend
# deux unités ; ASC ne retrouve pas son code complet.

SUB Main()
    # Chr(13) et Chr(10) insèrent CRLF entre First et Second, sans envoyer le texte.
    # 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 summary = "First" & Chr(13) & Chr(10) & "Second"
    Return summary
END SUB

Explication des paramètres et du déroulement:

• Chr(13) et Chr(10) insèrent CRLF entre First et Second, sans envoyer le texte.
• 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.

Intercepter un code invalide

# Intercepter un code invalide
#
# Crée un caractère Unicode ou de contrôle pour composer du texte.
#
# String d’une ou deux unités UTF-16. Chr(0) contient NUL, pas une chaîne vide. Un emoji prend
# deux unités ; ASC ne retrouve pas son code complet.

SUB Main()
    # SafeCharacter retourne du texte vide en cas d’erreur. Pour 0x1F600, Len donne 2 malgré un seul
    # scalaire Unicode.
    # 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 = SafeCharacter(0x1F600)
    Return Len(symbol)
END SUB

Function SafeCharacter(code)
    Try
        Return Chr(code)
    Catch problem
        Return ""
    End Try
End Function

Explication des paramètres et du déroulement:

• SafeCharacter retourne du texte vide en cas d’erreur. Pour 0x1F600, Len donne 2 malgré un seul scalaire Unicode.
• 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.