Funktionen¶

Funktionen bieten die Möglichkeiten, Operationen auf Zeichenketten auszuführen, um so eine definierte Ergebniszeichenkette zu erhalten. Allgemein gilt also:

Result string = $func::Function name( input parameter )

Folgende Funktionen stehen im Skriptpaket zur Verfügung:

$func::getfilename({string})¶

• Ermittelt den Dateinamen (ohne Suffix) aus der übergebenen Zeichenkette. Beispiele

  $func::getfilename(C:\Test\log.txt) → log
  $func::getfilename(C:\Test\log) → log
  $func::getfilename(log.txt) → log
  $func::getfilename("C:\Test\log.txt") → log
  $func::getfilename(C:\Test\log\) →<empty>
  $func::getfilename() →<empty>
  $func::getfilename("") →<empty>
  

• Sucht eine Datei (Name mit Suffix) mit Wildcards. Beispiel

  $func::getfilename(C:\Test\*.txt) → C:\Test\test.txt (returns the first file that matches the search filter)
  

$func::getdir({string})¶

Ermittelt den Pfadnamen aus der übergebenen Zeichenkette.

Beispiele

$func::getdir(C:\Test\log.txt) → C:\Test\
$func::getdir(C:\Test\log) → C:\Test\
$func::getdir(log.txt) →<empty>
$func::getdir(C:\Test\log\) → C:\Test\log\
$func::getdir(NULL) →<empty>
$func::getdir("") →<empty>

$func::getshortdir({string})¶

Wandelt den übergebenen Pfad in die systemunterstützte Kurzform um.

Beispiel

$func::getshortdir(p:\vdBuild\vdC\ExampleComponents\Schneider Modsoft CatExample) → p:\vdBuild\vdC\BEISPI~1\SCHNEI~2\

$func::getparentdir({string})¶

Ermittelt den Pfadnamen aus der übergebenen Zeichenkette.

Beispiele

$func::getparentdir(C:\Test\log.txt) → C:\Test
$func::getparentdir(C:\Test\log) → C:\Test
$func::getparentdir(log.txt) →<empty>
$func::getparentdir(C:\Test\log\) → C:\Test
$func::getparentdir(NULL) →<empty>
$func::getparentdir("") →<empty>

$func::getdrive({string})¶

Ermittelt den Laufwerksbuchstaben aus der übergebenen Zeichenkette. Es wird davon ausgegangen, dass das Laufwerk nur durch EINEN Buchstaben beschrieben wird. Kann der Laufwerksbuchstabe nicht erkannt werden, so ist der Rückgabewert leer.

Beispiele

$func::getdrive(C:\Test\log.txt) → C
$func::getdrive(C:\) → C
$func::getdrive(C$) → C
$func::getdrive(\\Network\C$) → C
$func::getdrive(\\Network\C$\Temp) → C
$func::getdrive(\\Network\C\Temp) → C
$func::getdrive(C\) → C
$func::getdrive(\\Network\Temp\C\Temp) →<empty>
$func::getdrive(CD) →<empty>
$func::getdrive() →<empty>

$func::getsysvar({string})¶

Ermittelt die Umgebungsvariable/Systemvariable, die der übergebenen Zeichenkette zugeordnet ist.

Beispiel

$func::getsysvar(TEMP) → returns the value behind the system variable "TEMP", in this case it would be the system's
temp directory.