$FINDFILE (find files)

$FINDFILE searches files in the specified folder.

Organization of this page

Syntax

$FINDFILE(folder-name,array-name)

folder-name

Specifies a path relative to the base path, as either a constant or a variable. A constant must be enclosed in single quotation marks ('').
array-name

Specifies the name of the array that stores the name of the folder and the names of files in the folder, expressed as a variable.

For this array, File and Directory are specified by the key value for file and folder, respectively.

The following table lists and describes the possible statuses:

Status	Description
`NORMAL`	Normal end
`ERROR`	The specified folder is invalid.
Script execution interrupted	Indicates one of the following A wildcard or a character string such as `..` or `.` was included in `folder-name`. An invalid argument was specified, or an error other than the above occurred.

Status

Description

NORMAL

Normal end

ERROR

The specified folder is invalid.

Script execution interrupted

Indicates one of the following

A wildcard or a character string such as .. or . was included in folder-name.
An invalid argument was specified, or an error other than the above occurred.

This example searches files in Asset-Console-installation-folder\wwwroot\bin and outputs the name of the first file:

$FINDFILE('bin', FileData)
FILE=$GETARRAY(FileData, 1)
$ECHO(FILE)