Variables and Functions

What's New - Variables and Functions Added or updated the following 
internal variables (all variables listed are new unless otherwise noted): 

        »  _APMAC:  Advanced Power Management AC line status. 

        »  _APMBATT:  Advanced Power Management battery status. 

        »  _APMLIFE:  Advanced Power Management remaining battery life. 

        »  _CPU:  Now returns "686" for Pentium Pro. 

        »  _DOWI:  Returns the current day of week as an integer (Sun = 1, 
           Mon = 2, etc.). 

        »  _XPIXELS:  Returns the physical screen horizontal size in 
           pixels. 

        »  _YPIXELS:  Returns the physical screen vertical size in pixels. 
           
 

 3.01  »   _CMDPROC:  Returns the name of the current command processor. 
 

 Added or updated the following variable functions (all functions listed 
 are new unless otherwise noted): 

        »  @CLIP[n]:  Returns line n from the clipboard (base 0). 

        »  @CONVERT[input,output,value]:  Converts a number from one base 
           to another. 

        »  @DAY[date]:  Returns the day for the specified date. 

        »  @DOW[date]:  Returns the day of week for the specified date, as 
           a string (Sun, Mon, etc.) 

        »  @DOWI[date]:  Returns the day of week for the specified date, 
           as an integer (Sun = 1, Mon = 2, etc.). 

        »  @DOY[date]:  Returns the day of year for the specified date 
           (136). 

        »  @EAREAD[filename,EAname]:  Returns the specified text extended 
           attribute for the file. 

        »  @EAWRITE[filename,EAname,[value]]:  Writes the specified text 
           extended attribute for the file. 

        »  @EVAL[expression]:  Now supports user-definable decimal and 
           thousands characters; see DecimalChar and ThousandsChar, or 
           SETDOS /G for details. 

        »  @EXEC[command]:  This function has been modified; if you 
           preface the command with an '@', @EXEC will return an empty 
           string rather than the result code of the command. 

        »  @EXECSTR[command]:  Returns the first line written to STDOUT by 
           the specified command.  (This is intended to provide 
           functionality similar to UNIX back-quoting.) 

        »  @EXPAND[filename[,attributes]]:  Expands a wildcard filename 
           and returns all of the matching filenames / directories on a 
           single line. 

        »  @FILEDATE[filename[,acw]] / @FILETIME[filename[,acw]]:  Added 
           the optional second argument determines which date / time field 
           to return on HPFS drives. 

        »  @FILESIZE[filename[,bkm[,a]]:  Added the optional third 
           argument a(llocated); if specified, the function returns the 
           size actually used on disk, not the amount of data in the file. 
           

        »  @INSERT[n,string1,string2]:  Inserts string1 into string2 
           starting at offset n. 

        »  @LEFT[n,string]:  Returns the leftmost n characters of string. 

        »  @MONTH[date]:  Return the month for the specified date. 

        »  @NUMERIC[string]:  Now considers a leading decimal separator as 
           a numeric character, provided the remainder of the string is 
           numeric and does not contain additional decimal characters. 

        »  @REPLACE[string1,string2,text]:  Replaces all occurrences of 
           string1 in text with string2. 

        »  @RIGHT[n,string]:  Returns the rightmost n characters of 
           string. 

        »  @SEARCH[filename[,path]]:  Now accepts an optional second 
           argument for the path to search. 

        »  @SELECT[filename,top,left,bottom,right,title[,1]]:  Has a new 
           optional argument following the title.  If it's set to 1, 
           @SELECT will sort the list alphabetically. 

        »  @STRIP[chars,string]:  Return string with the characters in 
           chars removed. 

        »  @WILD[string1,string2]:  Does a wildcard comparison on the two 
           strings and returns 1 if they match; 0 if they don't. 

        »  @YEAR[date]:  Return the year for the specified date. 
 

 3.01  »   @EAWRITE[filename,EAname,[value]]: You can now delete an EA by 
           specifying an empty third argument (i.e., 
           "%@earead[filename,.subject,]).