Funktionen sind kleine Unterprogramme, die im Gegensatz zu einem Sub einen Wert zurückgeben. Das Hauptprogramm, eine andere Funktion, Sub oder sogar die Funktion können sie jederzeit aufrufen.
Jede Seite enthält meist eine Funktionsbeschreibung und Quellcode, Aufruf, ein Beispiel sowie ein Download der Funktion mit Beispiel.
Zu jeder Funktion ist ein Beispiel angegeben. Der Code im Beispiel erfüllt meist nur einen bestimmten Zweck. Die Funktion kann in den meisten Fällen natürlich auch für andere Zwecke benutzt werden.
Die Funktionsaufrufe in den Beispielen gehen davon aus, dass die Datei mit der Funktion im gleichen Verzeichnis liegt. Befindet sich die Datei in einem anderen Verzeichnis, ist ein absoluter oder relativer Pfad beim CALL notwendig. Hilfreich ist es, Funktionen vorzudefiniern.
Die Natur von Funktionen, nämlich die (Rück-) Übergabe von Werten mach die globale Verfügbarkeit von Variablen (Setlocal EnableDelayedExpansion) erforderlich.
Meine boolschen Funktionen geben -1 (wahr/true/ja) oder 0 (falsch/false/nein) und in manchen Fällen auch 1 für Fehler zurück. Es ist zwar nicht möglich die Art einer variablen zu definieren, aber gewisse Standards helfen.
Die erste Variable enthält immer den Namen der Variablen, in der die Rückgabe gespeichert werden soll. Dieser ist beim Aufruf frei wählbar.
Manche Funktionen benötigen wiederum andere meiner Funktionen (im gleichen Verzeichnis). Dies ist stets angegeben.
Meine Funktionen werden auch mal verbessert. Das seht ihr an der Versionsnummer im Download.
Genau wie meine Programme dürfen auch meine Funktionen benutzt werden und stehen frei zur Verfügung.