#muuid {59b0036e-5403-422e-883b-c9aaf425682b}
;============================================================
;  File: Variables.dll
;  Plugin: Variables
;  Version: 0.2.3.12
;  Authors: P Boon
;============================================================
[Adds support for dynamic variables in strings for plugins.]
;file \plugins\Variables\res\Variables.rc
[Parse options]
[Automatically strip "end of line" characters]
[Automatically strip white space]
[Automatically strip all non-parsing characters]
[Test area]
[Click on the help button to get more information]
[Parse the following string at startup]
[Auto parse]
[Parse]
[Please enter your input below]
[Don't set a contact]
[Set to the following contact]
[The token %subject% is translated into a special contact, which depends on the situation in which the string is parsed. Use this dialog to simulate the contact to which %subject% translates. An example for using this token is: !cinfo(%subject%,display).]
[Description]
[Setting]
[The token %extratext% is translated into a string which depends on the situation in which the string is parsed. Use this dialog to simulate the string to which %extratext% translates.]
[Close]
[The Variables plugin translates various tokens into a certain value. An example is: I'm running Miranda %mirandaversion%. The substring %mirandaversion% will be translated into the correct version number. The following list shows all available tokens.]
[Notes]
[Variables...]
;file \plugins\Variables\src\help.cpp
[Token]
[Tokens]
[Input]
[Cancel]
[Help]
[Variables Help]
[Open String Formatting Help]
;file \plugins\Variables\src\options.cpp
[Services]
[Variables]
;file \plugins\Variables\src\parse_alias.cpp
[Alias]
[user defined]
[stores y as alias named x]
;file \plugins\Variables\src\parse_external.cpp
[Stopped]
[Paused]
[External Applications]
[retrieves song name of the song currently playing in Winamp]
[retrieves current Winamp state (Playing/Paused/Stopped)]
;file \plugins\Variables\src\parse_inet.cpp
[Internet Related]
[converts each non-html character into hex format]
[converts each hex value into non-html character]
[converts a 32-bit number to IPv4 dotted notation]
[converts a 32-bit number (in host byte order) to IPv4 dotted notation]
;file \plugins\Variables\src\parse_logic.cpp
[Logical Expressions]
[performs logical AND (x && y && ...)]
[boolean FALSE]
[performs w, then shows z and performs y while x is TRUE]
[shows y if x is TRUE, otherwise it shows z]
[shows x if x is TRUE, otherwise it shows y (if(x,x,y))]
[the first argument parsed successfully]
[y if w = x, else z]
[y if w > x, else z]
[y if string length of w > x, else z]
[TRUE if x = y]
[TRUE if x > y]
[TRUE if x is longer than y]
[performs logical NOT (!x)]
[performs logical OR (x || y || ...)]
[boolean TRUE]
[performs logical XOR (x ^ y)]
;file \plugins\Variables\src\parse_math.cpp
[Mathematical Functions]
[x + y + ...]
[x divided by y]
[converts decimal value x to hex value and padds to length y]
[x modulo y (remainder of x divided by y)]
[x times y]
[x times y divided by z]
[minimum value of (decimal) arguments]
[maximum value of (decimal) arguments]
[pads decimal value x to length y with zeros]
[random number]
[x - y - ...]
;file \plugins\Variables\src\parse_metacontacts.cpp
[Metacontacts]
[get parent metacontact of contact x]
[get default subcontact x]
[get the 'most online' subcontact x]
;file \plugins\Variables\src\parse_miranda.cpp
[Miranda Core Global]
[path to Miranda root folder]
[path to folder containing Miranda profiles]
[name of current Miranda profile (filename, without extension)]
[will return parsed string %miranda_profilesdir%\\%miranda_profilename%]
[will return parsed string %miranda_profilesdir%\\%miranda_profilename%\\AvatarCache]
[will return parsed string %miranda_profilesdir%\\%miranda_profilename%\\Logs]
[Miranda Core OS]
[same as environment variable %APPDATA% for currently logged-on Windows user]
[username for currently logged-on Windows user]
["My Documents" folder for currently logged-on Windows user]
["Desktop" folder for currently logged-on Windows user]
[Miranda Related]
[translates status code x into a status description]
[zth contact with property y described by x, example: (unregistered,nick) (z is optional)]
[number of contacts with property y described by x, example: (unregistered,nick)]
[info property y of contact x]
[database profile name]
[database profile path]
[database setting z of module y of contact x and return w if z doesn't exist (w is optional)]
[get event for contact x (optional), according to y,z,w, see documentation]
[get last seen time of contact x in format y (y is optional)]
[get last seen date of contact x in format y (y is optional)]
[get last seen status of contact x]
[path to the Miranda NG executable]
[current status description of protocol x (without x, the global status is retrieved)]
[info property y of protocol ID x]
[retrieves the subject, depending on situation]
[translates x]
[get the version of Miranda]
[get the contact display name]
[get the date and time (using Miranda format)]
[TRUE if service function exists]
;file \plugins\Variables\src\parse_regexp.cpp
[Regular Expressions]
[(ANSI input only) the number of substring matches found in y with pattern x]
[(ANSI input only) substring match number z found in subject y with pattern x]
;file \plugins\Variables\src\parse_str.cpp
[String Functions]
[converts each first letter of a word to uppercase, all others to lowercase]
[converts each first letter of a word to uppercase]
[inserts 'end of line' character]
[depends on calling plugin]
[replace all occurrences of \\n (Unix) by \\r\\n (Windows)]
[cuts x after the first line and appends y (y is optional)]
[replaces all end of line characters by y (y is optional)]
[inserts string y at position z in string x]
[trims x to length y, keeping first y characters]
[length of x]
[the number of lines in string x]
[the longest string of the arguments]
[converts x to lowercase]
[no operation, x as given]
[pads x to length y prepending character z (z is optional)]
[pads x to length y appending character z (z is optional)]
[pads x to length y prepending character z, or cut if x is longer (z is optional)]
[pads x to length y appending character z, or cut if x is longer (z is optional)]
[repeats x y times]
[replace all occurrences of y in x with z, multiple y and z arguments allowed]
[trims x to length y, keeping last y characters]
[moves string x, z characters to the left and trims it to y characters]
[TRUE if x equals y]
[TRUE if x equals any of the following arguments]
[TRUE if the first z characters of x equal y]
[TRUE if x equals y, ignoring case]
[TRUE if the first z characters of x equal y, ignoring case]
[the shortest string of the arguments]
[location of first occurrence of character y in string x]
[location of last occurrence of character y in string x]
[location of first occurrence of string y in x]
[substring of x starting from position y to z]
[the xth string of the arguments]
[z if y equals x, multiple y and z arguments allowed]
[removes white spaces in before and after x]
[inserts x tab characters (x is optional)]
[converts x to upper case]
[words (separated by white spaces) number y to z from string x (z is optional)]
;file \plugins\Variables\src\parse_system.cpp
[System Functions]
[computer name]
[CPU load of process x (without extension) (x is optional)]
[current date in format y (y is optional)]
[current time in format y (y is optional)]
[the directory y directories above x]
[strips y directories from x]
[number of seconds between date x and y (x and y in format: M/d/yy H:m:s)]
[TRUE if directory x exists]
[TRUE if file x exists]
[window title of first window of class x]
[shows files and directories of directory x, with filter y, separated by z (y and z optional)]
[TRUE if process x is running]
[value y from registry key x (REG_SZ (string) values only)]
[formats timestamp x (seconds since 1/1/1970) in date format y]
[formats timestamp x (seconds since 1/1/1970) in time format y]
[y > 0: line number y from file x, y = 0: the whole file, y < 0: line y counted from the end, y = r: random line]
[uptime in seconds]
[expand environment variable x]
[user name]
[text from clipboard]
;file \plugins\Variables\src\parse_variables.cpp
[variable set by put(s) with name x]
[x, and stores y as variable named x]
[only stores y as variables x]
;file \plugins\Variables\src\stdafx.h
[--- Special characters ---\r\n\r\nThe following characters have a special meaning in a formatting string:\r\n\r\n?<function>(<arguments>)\r\nThis will parse the function given the arguments, the result will be parsed again. Example: Today is ?cdate(yyyy/MM/dd).\r\n\r\n!<function>(<arguments>)\r\nThis will parse the function given the arguments, the result will not be parsed again. Example: Message waiting: !message(,first,rcvd,unread).\r\n\r\n%<field>%\r\nThis will parse the given field. Example: I installed Miranda at: %mirandapath%.\r\n\r\n`<string>`\r\nThis will not parse the given string, any function, field or special character in the string will shown in the result without being translated. Example: Use `%mirandapath%` to show the installation path.\r\n\r\n#<comment>\r\nThis will add a comment in the formatting string. Everything from the # character to the end of the line will be removed. Example: %dbprofile% #this is a useless comment.\r\n\r\n\r\n--- Contacts ---\r\n\r\nWhenever a functions requires a contact as an argument, you can specify it in two ways:\r\n\r\n(1) Using a unique ID (for example JID for Jabber) or, a protocol ID followed by a unique ID in the form <PROTOID:UNIQUEID>, for example <JABBER:miranda@example.com>.\r\n\r\n(2) Using the contact function:\r\n?contact(x,y)\r\nA contact will be searched which will have value x for its property y, y can be one of the following:\r\nfirst, last, nick, email, ID or display\r\n\r\nFor example: ?contact(miranda@example.com,email) or ?contact(Miranda,nick). The contact function will return either a unique contact according to the arguments or nothing if none or multiple contacts exists with the given property.]
;file \plugins\Variables\src\variables.cpp