• Table of contents
• File/Folder Manipulation
  • $crc
  • $exists
  • $file
  • $finddir
  • $findfile
  • $getdir
  • $isdir
  • $isfile
  • $lines
  • $logdir
  • $longfn
  • $shortfn
  • $mididir
  • $mircexe
  • $adiircexe
  • $mircini
  • $adiircini
  • $mircdir
  • $adiircdir
  • $mklogfn
  • $msfile
  • $nofile
  • $nopath
  • $read
  • $readn
  • $sdir
  • $sfile
  • $sysdir
  • /write

File/Folder Manipulation¶

$crc¶

Added in 1.9.0

$crc(text|&binvar|filename,[N])

Returns the CRC checksum of the specified item.

Parameters

Parameter	Description
text|&binvar|filename	Value to calculate CRC checksum from.
N	0 = plain text, 1 = &binvar, 2 = filename (content of the file), 2 is default.

$exists¶

Added in 1.9.0

$exists(file|dir)

Returns $true if a file or dir exists otherwise $false.

See also $isfile $isdir.

Parameters

Parameter	Description
file|dir	File or directory.

Example

; Check if file exists
if ($exists(c:\windows\notepad.exe) file exists

; Check if directory exists
if ($exists(c:\windows) directory exists

$file¶

Added in 1.8.10

$file(filename|foldername|name)

Returns information about the specified file or folder.

Default returns file size.

Same as $lof.

Parameters

Parameter	Description
filename|foldername|name	Filename or folder or open file in $fopen to retrieve information from.

Properties

Property	Description
.size	File size in bytes. (returns 0 for folders)
.ctime	Creation time. (unix timestamp)
.mtime	Last modification time. (unix timestamp)
.atime	Last access time. (unix timestamp)
.shortfn	Short file name.
.longfn	Full file name.
.attr	File attributes.
.sig	Returns "ok" if digital signed, else "none".
.version	Returns the file version, if any.
.path	The path directory.
.name	The filename without the file extension.
.ext	The file extension.
.pid	Returns the first process id started by this file. (AdiIRC Only)

Example

; Show AdiIRC.exe filesize
//echo -ag $file($adiircexe).size

; Show explorer.exe digital signature
//echo -ag $file(c:\windows\explorer.exe).sig

$finddir¶

Added in 1.9.0

$finddir(dir,wildcard,N,[depth],[@window|command])

Searches the specified directory and its sub directories for the Nth directory name matching the wildcard specification and returns the full path and directory if it is found.

If /halt is used in the [command], the search is halted instead of the entire script.

Parameters

Parameter	Description
dir	The directory to search.
wildcard	Wildcard to search for.
N	If N = 0, number of directories, otherwise the Nth directory.
[depth]	Maximum folder depth. (optional)
[@window|command]	Custom window name to fill with the result or a command to run on each result. (optional)

Properties

Property	Description
.shortfn	Return the path in a shortfn format.

Example

; Print number of sub directories found in $adiircdir.
//echo -ag $finddir($adiircdir,*.*,0)

; Print the 1st directory found.
//echo -ag $finddir($adiircdir,*.*,1)

; Print all sub directories in $adiircdir, when using the command parameter, $1- will hold the path.
//noop $finddir($adiircdir,*.*,0,echo -ag $1-)

$findfile¶

Added in 1.9.0

$findfile(dir,wildcard,N,[depth],[@window|command])

Searches the specified directory and its subdirectories for the Nth filename matching the wildcard file specification and returns the full path and filename if it is found.

If /halt is used in the [command], the search is halted instead of the entire script.

Parameters

Parameter	Description
dir	The directory to search.
wildcard	Wildcard to search for.
N	If N = 0, number of files, otherwise the Nth filename.
[depth]	Maximum folder depth. (optional)
[@window|command]	Custom window name to fill with the result or a command to run on each result. (optional)

Properties

Property	Description
.shortfn	Return the path in a shortfn format.

Example

; Print number of filenames found in $adiircdir.
//echo -ag $findfile($adiircdir,*.*,0)

; Print the 1st filename found.
//echo -ag $findfile($adiircdir,*.*,1)

; Print all filenames in $adiircdir, when using the command parameter, $1- will hold the path.
//noop $findfile($adiircdir,*.*,0,echo -ag $1-)

$getdir¶

Added in 1.9.0

$getdir

Returns the DCC download directory specified in Options -> DCC.

---

$getdir(filespec)

Returns the DCC download directory matching the filespec, otherwise the directory specified in Options -> DCC.

Parameters

Parameter	Description
filespec	The filespec.

Example

; Get the directory for .mp3 files.
//echo -ag $getdir(*.mp3)

$isdir¶

Added in 1.8.10

$isdir(dirfile)

Returns $true if the specified directory exists, otherwise $false.

Parameters

Parameter	Description
dirfile	Directory to check.

Example

; Check if 'windows' exists.
//if ($isdir(C:\Windows)) echo -ag directory exists

$isfile¶

Added in 1.8.10

$isfile(file)

Returns $true if the specified file exists, otherwise $false.

Parameters

Parameter	Description
file	File to check.

Example

; Check if notepad.exe exists.
//if ($isfile(C:\Windows\notepad.exe)) echo -ag file exists

$lines¶

Added in 1.9.0

$lines(filename)

Returns the total number of lines in the specified text file.

Parameters

Parameter	Description
filename	Filename to read from.

Example

;Open a file for writing
/fopen file file.txt

;Write a line to the file
/fwrite file Hello World

;Close the file
/fclose file

;Print the number of lines in file.txt
//echo -ag $lines(file.txt)
<pre>

$logdir¶

Added in 1.8.10

$logdir

Returns the Logs directory set in Options -> Logging -> Log folder.

$longfn¶

Added in 1.9.0

$longfn(filename)

Returns the long version of a short filename.

Parameters

Parameter	Description
filename	The filename.

Example

alias Example {
  ; Get the shortfn of AdiIRC.exe
  var %short $shortfn($adiircexe)

  ; Print the long filename
  echo -ag $longfn(%short) vs %short
}

$shortfn¶

{{include($shortfn}}

$mididir¶

$mircexe¶

Added in 1.9.0

$mircexe

Returns the full path and filename of the AdiIRC executable file.

Same as $adiircexe.

Can be used inside text without being surrounded by white spaces.

Example

//echo -ag the adiirc exe file is $mircexe.. notice how $mircexeisreplacedhere

$adiircexe¶

Added in 1.9.0

$adiircexe

Returns the full path and filename of the AdiIRC executable file.

In combination with $~ this can be used to test which client is running the script. You cannot assume the client name based on the filename.exe, but instead testing whether $adiircexe exists as a built-in identifier. The $~ prefix allows the test to evade the presence of a custom alias of that name, and it also does not trigger the optional identifier warning.

//if (!$~adiircexe) echo -a this script is not running in AdiIRC

Same as $mircexe.

Can be used inside text without being surrounded by white spaces.

Example

//echo -ag the adiirc exe file is $adiircexe.. notice how $adiircexeisreplacedhere

$mircini¶

Added in 1.9.0

$mircini

Returns the full path and filename of the AdiIRC settings file (config.ini).

Same as $adiircini.

Can be used inside text without being surrounded by white spaces.

Example

//echo -ag the adiirc ini file is $mircini .. notice how $mirciniisreplacedhere

$adiircini¶

Added in 1.9.0

$adiircini

Returns the full path and filename of the AdiIRC settings file (config.ini).

Same as $mircini.

Can be used inside text without being surrounded by white spaces.

Example

//echo -ag the adiirc ini file is $adiircini.. notice how $adiirciniisreplacedhere

$mircdir¶

Added in 1.9.0

$mircdir

Returns the directory where AdiIRC stores its settings, themes, scripts and so on.

Same as $adiircdir.

Can be used inside text without being surrounded by white spaces.

Example

; Print the scripts folder, no space after $mircdir is needed.
//echo -ag $mircdir\Scripts

$adiircdir¶

Added in 1.9.0

$adiircdir

Returns the directory where AdiIRC stores its settings, themes, scripts and so on.

Can be used inside text without being surrounded by white spaces.

Same as $mircdir.

Example

; Print the scripts folder, no space after $adiircdir is needed.
//echo -ag $adiircdir\Scripts

$mklogfn¶

Added in 1.9.0

$mklogfn(filename)

Returns the filename formatted according to options set in Options -> Logging.

Parameters

Parameter	Description
filename	The filename to format.

$msfile¶

{{include($msfile}}

$nofile¶

{{include($nofile}}

$nopath¶

{{include($nopath}}

$read¶

{{include($read}}

$readn¶

{{include($readn}}

$sdir¶

{{include($sdir}}

$sfile¶

{{include($sfile}}

$sysdir¶

{{include($sysdir}}

/write¶

{{include(/write}}