Built-In Functions

File Functions

The file functions are evaluated once for each file in the file table to generate a set of files for the expression. The evaluation loop is done for the whole expression being evaluated, so that if multiple file functions are present in an expression, their values are all based on the same file for each loop of the evaluation.

fileIndex() The offset of each file in the file table
fileExtension() The extension of each file name
fileBaseName() The base name of the last component
fileDepth() The number of components in each file name
fileLastComponent() The last component of each file name
fileDirPath() The directory path of each file
fileFullPath() The full path of each file
filePrefixName() The prefix name for each file's path
filePrefixPath() The prefix path for each file's path
fileSuffixPath() The suffix path for each file's path
fileType() The file system type of each file
fileLength() The length of each file
fileOwner The owner of each file
fileGroup The group of each file
fileCreation The time the file was created
fileLastModified The time the file was last modified
fileLastAccess The time the file was last accessed
filePermissions The permissions of the file (e.g., rwxr-xr-x)
fileAccess The user's access to the file
fileLinkValue The target value of a symbolic link
fileKey The key value for the file (e.g., device, inode)
fileChecksum() The checksum of each file if calculated
fileContentType The file's MIME content type if probed

String Functions

length(str) The length of a string
lowerCase(str) The lower case value of a string
startsWith(str1, str2) Whether one string starts with another
endsWith(str1, str2) Whether one string ends with another
contains(str1, str2) Whether one string contains a second string
matches(str, pat) Whether one string is matched by a regular expression
toString(expr) The string value of an expression

Numeric Functions

min(num1, num2) The minimum value of two numbers
max(num1, num2) The maximum value of two numbers
abs(num) The absolute value of a number

Other Functions

time([str]) The current time or the specified time
timeAdd(time, seconds) The addition of the specified number of seconds to a time