Differences

This shows you the differences between two versions of the page.

--- jvs:fscan:manual:chapter4 [2013/08/14 15:48]
voyvodic
+++ jvs:fscan:manual:chapter4 [2023/02/23 18:43] (current)
@@ Line 12: / Line 12: @@
 ==== Accessing data variables ====
-In general, data variable values can be accessed by specifying the name of the variable, preceded by the '$' character.  To get the status of a variable, substitute '?' for '$'; the status is -1 if the named variable is not defined, it is 0 if it is defined but empty, and it is a positive value (the size of the variable) if it is defined and not empty.
+In general, data variable values can be accessed by specifying the name of the variable, preceded by the '$' character (or '_' character to make command-line scripting easier).  To get the status of a variable, substitute '?' for '$'; the status is -1 if the named variable is not defined, it is 0 if it is defined but empty, and it is a positive value (the size of the variable) if it is defined and not empty.
+Variable operators:
+  * $varbname - the value of the named variable (_varbname works the same)
+  * ?varbname - the status of the named variable (0=undefined, 1=defined)
 For example:\\
@@ Line 18: / Line 22: @@
   * -echo Varb: ?curdir ?thiswin ?myvarb            ; test whether these variables are defined
-Variable operators:
+The '$' character is also used to identify fScan special functions of the form: $funcname(). Examples are:
-  * $
+  * $exists(filename) - does the named file exist (0=no, 1=regular file, 2=directory)?
-  * ?
+  * $filepath(filename) - return the full path to the named file
-  * exists
+  * $relpath(filename) - return the relative path (from $curdir)
-  * filepath
+  * $date(filename) - return a string containing the file modification date (yyyymmddhhmmss)
-  * relpath
+  * $age(filename) - return the age of the named file in seconds
   * tables
     * listitem

Brain Imaging & Analysis Center

User Tools

Site Tools

Differences

Page Tools