Functions > String >


StringFromASCIIArray

Convertit un tableau de codes ASCII en une chaîne de caractères.

StringFromASCIIArray ( array,[start = 0 [, end = -1 [, encoding = 0]]] )

Paramètres

array Le tableau de codes ASCII à convertir en caractères.
start [optionnel] L'index de base 0 où commencer le traitement (par défaut 0).
end [optionnel] L'index de base 0 où terminer le traitement (par défaut: UBound($aArray)). Notez que le caractère à cet index n'est PAS inclus dans la sortie.
encoding [optionnel] Le tableau contient des valeurs dans un jeu de caractères spécifié:
    $SE_UTF16 (0) = UTF-16 (par défaut)
    $SE_ANSI (1) = ANSI
    $SE_UTF8 (2) = UTF-8

Les constantes sont définies dans "StringConstants.au3".

Valeur de retour

Succès: Retourne une chaîne contenant des caractères représentants les codes ASCII.
Échec: Retourne une chaîne vide et définit @error <> 0.
@error: 1 = le paramètre n'est pas un tableau.
2 = l'index du début n'est pas valide.

Remarques

La chaîne retournée peut contenir Chr(0) mais sera encore de type chaîne. La plupart des fonctions chaînes stopperont au premier Chr(0) rencontré, cependant, si l'accès au contenu entier de la chaîne est nécessaire alors la fonction StringToBinary() peut la convertir en un BinaryString pour préserver toutes les données.

Si vous essayez de créer un tableau manuellement (par opposition à l'utilisation d'un tableau retourné par StringToASCIIArray()), alors les codes dans le tableau doivent être spécifiés en UNICODE.

En relation

StringToASCIIArray

Exemple

#include <MsgBoxConstants.au3>
#include <Array.au3> ; Nécessaire pour _ArrayDisplay() seulement.

Example()

Func Example()
    ; Convertit la chaîne en un tableau ASCII.
    Local $aArray = StringToASCIIArray("Ceci est une phrase avec 'whitespace'.")

    ; Affiche le tableau pour voir qu'il contient les valeurs ASCII pour chaque caractère de la chaîne.
    _ArrayDisplay($aArray)

    ; Convertit le tableau en une chaîne.
    Local $sString = StringFromASCIIArray($aArray)

    ; Affiche la chaîne pour voir qu'elle correspond à la chaîne d'origine d'abord convertie en un tableau.
    MsgBox($MB_SYSTEMMODAL, "", $sString)
EndFunc   ;==>Example