_ArrayToString
Schreibt die Elemente eines 1D oder 2D Arrays, durch das angegebene Trennzeichen getrennt, in einen String
#include <Array.au3>
_ArrayToString ( Const ByRef $aArray [, $sDelim_Col = "|" [, $iStart_Row = Default [, $iEnd_Row = Default [, $sDelim_Row = @CRLF [, $iStart_Col = Default [, $iEnd_Col = Default]]]]]] )
Parameter
| $aArray | Das Array, das in ein String umgewandelt werden soll. |
| $sDelim_Col | [optional] Trennzeichen für Elemente eines 1D Arrays oder Spalten eines 2D Arrays |
| $iStart_Row | [optional] Beginn Zeilenindex des Arrays (Standard = 0) |
| $iEnd_Row | [optional] Ende Zeilenindex des Arrays (Standard = Anzahl Zeilen) |
| $sDelim_Row | [optional] Trennzeichen für Zeilen eines 2D-Arrays (nur 2D) |
| $iStart_Col | [optional] Beginn Spaltenindex des Arrays (nur 2D) (Standard = 0) |
| $iEnd_Col | [optional] Ende Spaltenindex des Arrays (nur 2D) (Standard = Anzahl Spalten) |
Rückgabewert
| Erfolg: | ein durch Trennzeichen getrennten String mit allen einzubeziehenden Werten |
| Fehler: | Setzt das @error Flag auf ungleich null |
| @error: | 1 - $aArray ist kein Array 2 - $aArray ist kein 1D oder 2D Array 3 - $iStart_Row oder $iEnd_Row außerhalb der Arraygrenzen 4 - $iStart_Row ist größer als $iEnd_Row 5 - $iStart_Col oder $iEnd_Col außerhalb der Arraygrenzen 6 - $iStart_Col ist größer als $iEnd_Col |
Bemerkungen
Wenn das übergebene Array eines der folgenden Formate und keinen Inhalt hat - [0], [1], [0][0], [1][0], [0][1], [1][1] - gibt diese Funktion einen leeren String zurück.
Wenn dieser String anschließend an _ArrayFromString() übergeben wird, kann diese Funktion nicht zwischen diesen Fällen unterscheiden und gibt ein einzelelementiges Array ohne Inhalt zurück: entweder [1] oder [1][1], abhängig vom $bForce2D-Flag.
Verwandte Funktionen
_ArrayFromString, _ArrayToClip
Beispiel
#include <Array.au3>
#include <MsgBoxConstants.au3>
Local $aArray[20]
For $i = 0 To 19
$aArray[$i] = $i
Next
_ArrayDisplay($aArray, "1D Array")
MsgBox($MB_SYSTEMMODAL, "Items 1-7", _ArrayToString($aArray, @TAB, 1, 7))
Local $aArray[10][10]
For $i = 0 To 9
For $j = 0 To 9
$aArray[$i][$j] = $i & "-" & $j
Next
Next
_ArrayDisplay($aArray, "2D Array")
MsgBox($MB_SYSTEMMODAL, "Zeilen 4-7, Spalten 2-5", _ArrayToString($aArray, " :: ", 4, 7, @CRLF, 2, 5))