Funciones¶

Las funciones ofrecen la posibilidad de realizar operaciones con cadenas de caracteres para obtener una cadena de resultados definida. En general, se aplica lo siguiente:

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

Las siguientes funciones están disponibles en el paquete de scripts:

$func::getfilename({cadena})¶

• Determina el nombre del archivo (sin sufijo) a partir de la cadena de caracteres transferida. Ejemplos

  $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>
  

• Busca un archivo (nombre con sufijo) con comodines. Ejemplo

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

$func::getdir({cadena})¶

Determina el nombre de la ruta a partir de la cadena transferida.

Ejemplos

$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({cadena})¶

Convierte la ruta transferida en la forma abreviada compatible con el sistema.

Ejemplo

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

$func::getparentdir({cadena})¶

Determina el nombre de la ruta a partir de la cadena transferida.

Ejemplos

$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({cadena})¶

Determina la letra de la unidad a partir de la cadena de caracteres transferida. Se supone que la unidad sólo se describe con UNA letra. Si no se puede reconocer la letra de la unidad, el valor de retorno está vacío.

Ejemplos

$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({cadena})¶

Determina la variable de entorno/variable de sistema que se asigna a la cadena de caracteres transferida.

Ejemplo

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