SortArray - Sortieren eines Arrays

Desktop Management Scripting-Sprache › Funktionen › Verschiedene Funktionen › SortArray - Sortieren eines Arrays

SortArray - Sortieren eines Arrays

Gültig für UNIX und Windows.

Die Funktion "SortArray" dient zum Sortieren von Arrays.

Diese Funktion hat das folgende Format:

SortArray(array as array) as Boolean

SortArray(array as array, start as integer) as Boolean

SortArray(array as array, start as integer, end as integer) as Boolean

Array: Gibt den Namen des zu sortierenden Arrays an.
Start: Gibt den Startindex für den Sortiervorgang an. Der Sortiervorgang beginnt beim Startindex und endet am Ende des Arrays.
End: Gibt den letzten Index für den Sortiervorgang an.

Mit der Funktion können nur Basistypen-Arrays verarbeitet werden. Je nach ausgewähltem Format wird folgendermaßen sortiert: 1. Das gesamte Array wird sortiert. 2. Das Array wird beginnend am Startindex sortiert. 3. Das Array wird beginnend am Startindex bis zum Ende sortiert.

Bei erfolgreichem Abschluss gibt die Funktion TRUE zurück, andernfalls FALSE.

Beispiel: Funktion "SortArray"

Dim a[10], b[10], i As Integer
Dim TAB As Char
TAB = chr(9)

For i=0 to 9
	a[i] = 10 - i
Next i

b = a
If SortArray(b) Then
	For i = 0 To 9
		Print("a("+Str(i)+")="+Str(a[i])+TAB+"b("+Str(i)+")="+Str(b[i]))
	Next i
Else
	Print("SortArray(b) failed!")
End If

Handhabung von Rückwärtskompatibilität oder unbekannten Funktionen

DMScript stellt Funktionen bereit, die neue Funktionen auf einem alten Interpreter oder unbekannte Funktionen innerhalb eines Skript verarbeiten. Die folgenden Funktionen helfen sicherzustellen, dass die neueren Skripte durch das Ignorieren der neuen oder unbekannten Funktionen erfolgreich auf älteren DSM-Agenten ausgeführt werden können:

ALLOW_UNRESOLVED_FUNCTIONS

Die IsFunctionSupported-Funktion überprüft, ob eine bestimmte Funktion von der aktuellen dmscript-Version verstanden wird. Diese Direktive hat das folgende Format:

#pragma ALLOW_UNRESOLVED_FUNCTIONS

Wenn Sie diese Direktive einem DMScript hinzufügen, führt der Compiler die folgende Aktion aus, wenn er eine unbekannte Funktion im Skript findet:

Fügt zur Kompilierzeit eine Warnung zum Verfolgungsprotokoll hinzu
Gibt Code aus, der einen schwerwiegenden Laufzeitfehler anzeigt, wenn das Skript versucht, die unbekannte Funktion zur Laufzeit auszuführen.

IsFunctionSupported

Die IsFunctionSupported-Funktion überprüft, ob eine Funktion unterstützt wird. Diese Funktion hat das folgende Format:

IsFunctionSupported(name as String) as Boolean

Beispiel: IsFunctionSupported

#pragma ALLOW_UNRESOLVED_FUNCTIONS
If IsFunctionSupported ("OpenDetectedSoftwareOutputFiles") then
OpenDetectedSoftwareOutputFiles ("A7C1E14A-7C93-4E17-B4E5-45B796717F49", "V1", "OS Detection for Windows")
else
    dsmtrace("error","Diese Version unterstützt keine Intellisigs.")
    exit
end if

Eingabeparameter

Diese Funktion hat den folgenden Eingabeparameter:

name: Legt den Namen der Funktion fest.

Rückgabewerte

Wenn die entsprechende Funktion entweder im Skript definiert ist oder eine integrierte Funktion ist, gibt die Funktion "true" zurück, ansonsten "false". Diese Funktion wird zusammen mit dem ALLOW_UNRESOLVED_FUNCTIONS-pragma verwendet, um Skripten die Handhabung der Rückwärtskompatibilität zu ermöglichen. Wenn ein Skript eine Funktion verwendet, die in der aktuellen Version, aber nicht in früheren Versionen vorhanden ist, schlägt die Skriptkompilierung fehl, und es wird keine Aktion auf Computern ausgeführt, auf denen die alten Versionen laufen. IsFunctionSupported ermöglicht solch einem Skript, die Kompilierung auf alten Versionen durchzuführen und zur Laufzeit eine besondere Aktion auszuführen, um die fehlende Funktion zu verarbeiten. Es ist nicht möglich, die fehlende Funktion auszugleichen, aber es wird eine Fehlermeldung ausgegeben, die vom Benutzer gelesen werden kann.

Hinweis: Sie können auch die Funktionen GetFileInfo und CompareVersions verwenden, um zu überprüfen, dass das Skript unter einer bestimmten DMScript-Version ausgeführt wird.