https://docs.dopus.com/ 2026-04-14T08:00:48+00:00 https://docs.dopus.com/ https://docs.dopus.com/lib/exe/fetch.php?media=logo.png text/html 2023-09-11T03:55:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:abortfunc&rev=1694404515&do=diff When called from within a function, aborts the execution of the remainder of the function. Example: =if ("%USERNAME%" == "jon") AbortFunc(); @confirm Hi there, person who isn't Jon! text/html 2023-11-20T23:11:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:abs&rev=1700521898&do=diff Returns the absolute (i.e. positive) value of the input value. text/html 2025-08-25T05:14:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:adjustdate&rev=1756098876&do=diff Adjust a date from one timezone to another. Timezones can be specified as a positive or negative number of minutes, relative to UTC. For example, a value of 60 represents GMT+1. Timezones can also be referred to by their name in the system registry or IANA name. For example, text/html 2024-03-16T22:03:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:age&rev=1710626624&do=diff Returns the difference between the the current date and the supplied dates, expressed as units (defaults to days). Example: Output(Age("2021-01-01")) --> 1158 text/html 2023-08-11T07:52:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arg&rev=1691740359&do=diff Returns the value of a user command argument. User commands can therefore use the Evaluator to modify their behavior based on the value of a supplied argument. Example: @if:=(Arg("NAME")=="jon") echo Hi Jon! @if:else echo Who are you? text/html 2025-12-09T21:50:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arraycopy&rev=1765317009&do=diff Creates a new copy of an existing array. By default the entire array is copied. You can optionally specify a range of elements to copy with the index parameters. If only index1 is specified, the array is copied from that element to the end. Examples: text/html 2025-12-09T21:47:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arraycreate&rev=1765316821&do=diff Creates a new array. If arguments are provided the array is initialised with those values. Examples: arr = ArrayCreate(1,2,3,5,8,13,21); See also: ArrayCopy ArrayErase ArrayGet ArrayPop ArrayPush ArrayRev ArraySet ArraySort text/html 2025-12-09T21:52:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arrayerase&rev=1765317177&do=diff Erases the specified range of values from the array. If neither index is provided all values are erased. If index2 isn't provided all values from the specified index to the end of the array are erased. Examples: arr = ArrayCreate(1,2,3,5,8,13,21); ArrayErase(arr, 2, 4); Output(arr); -> {1, 2, 13, 21} text/html 2025-12-09T23:33:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arrayget&rev=1765323228&do=diff Returns the value of the element at the specified index. See also: ArrayCreate ArrayCopy ArrayErase ArrayPop ArrayPush ArrayRev ArraySet ArraySort text/html 2025-12-09T23:35:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arraypop&rev=1765323333&do=diff Removes (pops) the last element from the array. See also: ArrayCreate ArrayCopy ArrayErase ArrayGet ArrayPush ArrayRev ArraySet ArraySort text/html 2025-12-09T23:42:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arraypush&rev=1765323722&do=diff Adds (pushes) the specified value onto the end of the array. See also: ArrayCreate ArrayCopy ArrayErase ArrayGet ArrayPop ArrayRev ArraySet ArraySort text/html 2025-12-09T23:48:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arrayrev&rev=1765324113&do=diff Reverse the order of the elements in the specified array. See also: ArrayCreate ArrayCopy ArrayErase ArrayGet ArrayPop ArrayPush ArraySet ArraySort text/html 2025-12-09T23:52:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arrayset&rev=1765324336&do=diff Stores the value in the array at the specified index. If the array isn't large enough it's automatically resized. See also: ArrayCreate ArrayCopy ArrayErase ArrayGet ArrayPop ArrayPush ArrayRev ArraySort text/html 2025-12-09T23:49:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:arraysort&rev=1765324177&do=diff Sorts the elements in the specified array. See also: ArrayCreate ArrayCopy ArrayErase ArrayGet ArrayPop ArrayPush ArrayRev ArraySet text/html 2025-02-04T05:03:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:as&rev=1738645423&do=diff The As operator performs two functions - conversion and formatting. Conversion: varname As type Converts the variable varname to the specified type. Valid types are: boolboolean (true or false)intsigned 32-bit integeruintunsigned 32-bit integerint64 text/html 2023-08-20T01:40:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:asc&rev=1692495645&do=diff Returns the ANSI or Unicode code for the first character of string. Example: Output( Asc("Hello") ); --> 72 See also: Chr text/html 2023-10-28T06:42:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:atan&rev=1698475354&do=diff Computes the arc tangent of (measured in radians). text/html 2023-08-09T05:05:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:capitalize&rev=1691557524&do=diff Returns the capitalized version of string. By default, just the first letter is capitalized. Use the optional type parameter to select a different capitalization method. Example: Output( Capitalize("hello world", 1) ); --> Hello World See also: text/html 2023-10-28T06:43:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:cbrt&rev=1698475387&do=diff Computes the cube root of . text/html 2023-11-21T22:44:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:ceil&rev=1700606686&do=diff Rounds the input value up to the nearest integer (toward positive infinity). Example: Output( Ceil(1.6) ); --> 2.000000 See also: Floor Round text/html 2023-08-20T01:40:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:chr&rev=1692495652&do=diff Returns a string containing the character equivalent of the specified code. Example: Output( Chr(65) ); --> A See also: Asc text/html 2024-02-20T05:42:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:clip&rev=1708407778&do=diff Returns the text currently on the clipboard (or an empty string if the clipboard doesn't contain text). text/html 2023-11-20T22:02:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:clipformat&rev=1700517738&do=diff With no arguments, returns a string identifying the type of data currently on the clipboard. Possible clipboard data types are: files (if wantcut is False or omitted) files_copy (if wantcut is True) files_cut (if wantcut is True) image text text/html 2025-02-04T05:10:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:concat&rev=1738645839&do=diff Joins one or more strings together and returns the result. Empty strings are skipped. The joiner string is used to join each pair of strings. If not provided, a space is the default. The final string is used to join the final string. If not provided, the regular joiner string is used. text/html 2023-10-28T06:43:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:cos&rev=1698475406&do=diff Computes the cosine of (measured in radians). text/html 2023-09-04T09:51:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:count&rev=1693821105&do=diff Returns the number of components in the path. Example: p: path = "C:\Windows\System32"; Output( Count(p) ); --> 3 See also: IsParent Parent ---------- Returns the number of times substring is found in string. The optional flag c makes the search case-sensitive. text/html 2023-08-09T05:05:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:datediff&rev=1691557534&do=diff Returns the difference between the two supplied dates, expressed as units. Example: Output(DateDiff("yyyy", "2021-01-01", "2023-01-01")) --> 2 text/html 2026-03-19T05:32:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:datepart&rev=1773898352&do=diff Returns the value of the specified part, or formats one or more date parts into a string. If returning a single value that can be interpreted as a number, the value will be returned as an integer. If returning multiple parts (as in the example below), a text/html 2023-10-28T06:44:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:degtorad&rev=1698475445&do=diff Converts from degrees to radians. text/html 2025-12-10T00:43:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:dialog&rev=1765327410&do=diff Lets you display various types of dialog to the user and retrieve the selection or entered text. Request dialog Shows a request dialog with one or more buttons. Returns the ID of the chosen button. The buttons string can separate multiple buttons with a text/html 2023-08-08T05:42:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:displayname&rev=1691473378&do=diff Returns the display name of the file or folder. Example: Output(DisplayName("/desktop")); --> Desktop Output(DisplayName("/desktop", "p")); --> C:\Users\jon\Desktop See also: Resolve text/html 2025-02-24T21:34:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:dumpvars&rev=1740432859&do=diff Returns a concatenated list of all current evaluator variables and their types/values. Useful for debugging. With no arguments all variables will be returned, otherwise you can supply one or more regular expressions to match variables by name. Example: text/html 2023-09-15T21:04:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:elapsed&rev=1694811897&do=diff Measures the time in milliseconds of a named elapse timer since it was started. Timers are global, so you should pick a unique name. The first time the specified timer is measured it is started. If called with just a single argument, the return value is the number of milliseconds since the timer was started. text/html 2025-12-10T00:51:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:es&rev=1765327915&do=diff Returns the input string with escaped characters converted to literal characters. Escape sequences are: \'single quote\"double quote\\backslash\bbackspace\nnew line\rcarriage return\thorizontal tab\nnnoctal value\xn..hexadecimal value\unnnnUnicode code point (4 hex digits) text/html 2025-07-23T05:45:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:escapewild&rev=1753249535&do=diff Escapes all wildcard characters in the input string and returns the result. The optional flags are: rescape characters used in regular expressionsbdouble all backslashesndouble backslashes that come before the letter 'n' Example: Output(EscapeWild("*.*")); --> '*.'* text/html 2023-08-07T02:44:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:exists&rev=1691376274&do=diff Tests if the specified path exists (or optionally, if any file or folder matching the wildcard exists in the specified path). Example: if (Exists("c:\\log\\error*.txt", "w")) { ... } text/html 2025-12-10T02:00:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:explode&rev=1765332057&do=diff Splits an input string into an array of smaller strings. If separators aren't specified it will split on spaces by default. The optional limit argument specifies the maximum number of strings to add to the array. Specify for no limit. The optional text/html 2023-08-07T07:12:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:filecount&rev=1691392355&do=diff Returns the total count of items matching pattern. Specify true for the selected argument for a count of selected items only. With multiple patterns specified, the return value is the sum of all items matching the supplied patterns. Example: if (FileCount("*.jpg") > 2) { ... } // at least three jpgs in folder if (FileCount(true, "dirs:new*") == 5) { ... } // 5 folders starting with new are selected text/html 2023-08-09T04:50:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:fileext&rev=1691556600&do=diff Returns the file extension of the specified filename. Example: Output(FileExt("file.jpg")); --> .jpg See also: FilePart Parent Root Stem text/html 2023-11-17T01:33:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:filepart&rev=1700184794&do=diff Returns the filename (trailing) component or components of the specified path. If components isn't specified, the final component is returned. Example: Output(FilePart("C:\one\two\file.jpg")); --> file.jpg See also: FileExt Parent Root Stem text/html 2024-08-30T02:08:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:findwindow&rev=1724983726&do=diff Searches for a top-level window in the system matching the specified class and/or title. You can specify just a class name, just a title name, or both a class and a title (in which case both must match). To specify a title without a class, use an empty string for the class name. text/html 2023-11-21T22:45:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:floor&rev=1700606707&do=diff Rounds the input value down to the nearest integer (toward negative infinity). Example: Output( Floor(1.6) ); --> 1.000000 See also: Ceil Round text/html 2023-08-07T06:10:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:format&rev=1691388648&do=diff Returns the formatted output string. Example: Output(Format("Hello %1!", "Jon")) --> Hello Jon! See also: As text/html 2026-03-19T05:45:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:getinfo&rev=1773899100&do=diff Returns an item of information from the specified tab. The return type depends upon the information requested. The available information is: AvailableSpaceAvailable space on the driveCheckCountNumber of checked itemsCheckSizeSize of checked itemsCount text/html 2025-12-10T02:08:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:getitems&rev=1765332516&do=diff Returns an array of files and folders from the specified tab. By default all items are returned from the source file display. The optional flags argument should be a string containing one or more of the following flags: lGet items from left file display. text/html 2023-11-20T23:28:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:hypot&rev=1700522917&do=diff Computes the square root of the sum of the squares of and (and , if three coordinates are given). text/html 2025-12-10T02:03:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:implode&rev=1765332198&do=diff Concatenates the members of an array to a single string, joining them with the specified separator. If separator isn't specified it will join with spaces by default. The optional flags are: qQuote individual strings if needed (i.e. if they contain a space). text/html 2023-09-04T09:52:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:instr&rev=1693821122&do=diff Returns the position that search was found within string, or -1 if not found. Example: Output(InStr("The quick brown fox", "quick")) --> 4 See also: Count text/html 2023-08-07T06:51:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isalpha&rev=1691391087&do=diff Returns True if string consists entirely of alphabetical characters, otherwise returns False. Example: Output(IsAlpha("abcde")) --> true Output(IsAlpha("ab3de")) --> false See also: IsDigit IsLower IsPunct IsSpace IsUpper text/html 2026-01-29T04:55:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:ischecked&rev=1769662554&do=diff When a single command string is provided, returns True or False to indicate whether a button running the specified command would appear checked (highlighted) or not. Example: if (IsChecked("Set FLATVIEW=mixed")) { ... } // Is FlatView - Mixed mode currently on? text/html 2023-08-07T06:50:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isdigit&rev=1691391043&do=diff Returns True if string consists entirely of digit characters, otherwise returns False. Example: Output(IsDigit("12345")) --> true Output(IsDigit("123a5")) --> false See also: IsAlpha IsLower IsPunct IsSpace IsUpper text/html 2024-07-25T05:36:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isdir&rev=1721885765&do=diff Tests if the specified path exists as a directory. Example: if (IsDir("c:\\windows\\system32")) { ... } text/html 2026-01-29T04:56:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isenabled&rev=1769662579&do=diff When a single command string is provided, returns True or False to indicate whether a button running the specified command would appear enabled or not. Example: if (IsEnabled("Set VIEW=thumbnails")) { ... } // Is thumbnails mode available? If two or more commands are provided, returns text/html 2024-07-25T05:36:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isfile&rev=1721885793&do=diff Tests if the specified path exists as a file. Example: if (IsFile("c:\\windows\\system32\\notepad.exe")) { ... } text/html 2023-08-20T01:40:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:islower&rev=1692495659&do=diff Returns True if string consists entirely of lowercase letters, otherwise returns False. Example: Output(IsLower("abcde")) --> true Output(IsLower("abCde")) --> false See also: IsAlpha IsDigit IsPunct IsSpace IsUpper text/html 2023-09-04T09:51:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isparent&rev=1693821078&do=diff Tests whether parent is a parent of child. If not, returns . Otherwise, returns the number of levels that parent is above child. Example: parentPath = "C:\Windows"; childPath = "C:\Windows\System32"; Output( IsParent(parentPath, childPath) ); --> 1 text/html 2023-08-07T07:11:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:ispath&rev=1691392306&do=diff Returns True if path is a fully-qualified pathname, otherwise returns False. Example: Output(IsPath("C:\Windows\System32")) --> true Output(IsPath("System32")) --> false text/html 2023-08-20T01:41:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:ispunct&rev=1692495665&do=diff Returns True if string consists entirely of punctuation characters, otherwise returns False. Example: Output(IsPunct("!.,;:")) --> true Output(IsPunct("!.,j:")) --> false See also: IsAlpha IsDigit IsLower IsSpace IsUpper text/html 2023-08-07T07:15:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isselected&rev=1691392500&do=diff With a single pattern specified, returns True if items matching that pattern are currently selected, otherwise returns False. With multiple patterns specified, returns 0 is no patterns match selected items, otherwise returns the index of the first match. text/html 2024-03-07T01:29:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isset&rev=1709774989&do=diff Returns True if all specified variables exist (within the context of this evaluation). Returns False if any do not exist. Example: if (IsSet("j")) { ... } // does a variable called "j" exist? if (IsSet("name", "ext")) { ... } // do variables called "name" and "ext" both exist? text/html 2023-08-07T06:57:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isspace&rev=1691391458&do=diff Returns True if string consists entirely of space characters (spaces, tabs, newlines), otherwise returns False. Example: Output(IsSpace(" ")) --> true Output(IsSpace("_____")) --> false See also: IsAlpha IsDigit IsLower IsPunct IsUpper text/html 2023-08-07T06:58:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:isupper&rev=1691391511&do=diff Returns True if string consists entirely of uppercase letters, otherwise returns False. Example: Output(IsUpper("ABCDE")) --> true Output(IsUpper("ABcDE")) --> false See also: IsAlpha IsDigit IsLower IsPunct IsSpace text/html 2023-08-08T03:33:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:keydown&rev=1691465596&do=diff Returns True if the specified qualifier key or keys are held down. If multiple keys are provided, all must be held down to return true. Valid keywords are none, shift, ctrl and alt. Example: if (KeyDown("shift", "ctrl"")) { ... } // are both shift and ctrl are down? text/html 2023-11-03T23:18:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:languagestr&rev=1699053522&do=diff This function mainly exists for the default toolbars, which in some cases need to be able to access the translation of a string in the currently selected language. You probably won't need this function yourself. For example, in the viewer toolbar, the following line sets the button's label to either "Copy Selection" or "Copy All" (in the current language), depending on whether a region is selected or not. text/html 2023-08-20T01:41:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:lcase&rev=1692495673&do=diff Returns string converted to lower-case. Example: Output( LCase("Hello World") ); --> hello world See also: Capitalize UCase text/html 2023-08-20T01:41:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:left&rev=1692495678&do=diff Returns length characters from the left side of string. Example: Output( Left("Hello World", 5) ); --> Hello See also: Mid Right text/html 2025-12-10T02:19:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:len&rev=1765333149&do=diff For strings, returns the length of the string in characters. For arrays, returns the number of elements in the array. Example: Output( Len("Hello") ); --> 5 Output( Len( ArrayCreate(1, 2, 3, 4) ) ); --> 4 text/html 2024-08-28T04:44:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:makelegal&rev=1724820256&do=diff Returns string with any illegal path characters removed or replaced. Example: Output( MakeLegal("*File<?>Name*.txt") ) --> #File(!)Name#.txt Output( MakeLegal("C:\Program Files", "n") ) --> C;_Program Files Output( MakeLegal("\\Server\\Share", "sf") ) --> Server/Share text/html 2025-12-10T02:22:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:match&rev=1765333323&do=diff For strings, returns True if the input string matches the specified wildcard pattern. For arrays, returns the first index that matched or -1 for no match. By default this uses standard pattern matching - specify the r flag to use regular expressions instead. For regular expression, partial match is automatically disabled if the pattern begins or ends with a text/html 2023-08-20T01:41:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:max&rev=1692495695&do=diff Returns the largest of the provided input values. You can provide as many values as you like.. The values should all be the same type as each other (e.g. all numbers, all dates, etc.) Example: Output( Max(2, -5, 7, 1) ); --> 7 See also: Min text/html 2023-08-20T01:41:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:mid&rev=1692495701&do=diff Returns length characters from string starting at position start. If length is -1 or omitted, returns from start to the end of the string. Example: Output( Mid("Hello To You", 6, 2) ); --> To See also: Left Right text/html 2023-08-20T01:41:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:min&rev=1692495707&do=diff Returns the smallest of the provided input values. You can provide as many values as you like.. The values should all be the same type as each other (e.g. all numbers, all dates, etc.) Example: Output( Min(2, -5, 7, 1) ); --> -5 See also: Max text/html 2023-08-08T05:10:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:now&rev=1691471433&do=diff Returns the current time and date. Example: if (DatePart(Now(), "yyyy") == 2023) { ... } // is it still 2023? text/html 2025-07-23T05:42:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:output&rev=1753249321&do=diff Outputs the provided string to the script log. Example: Output("Hello!"); --> Hello! text/html 2024-10-21T15:17:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:parent&rev=1729523825&do=diff Returns the parent of the specified path (i.e. the input path with the final component removed). The optional levels argument lets you go up more than one level. On error, an empty string will be returned. Example: Output(Parent("C:\one\two\file.jpg")); --> C:\one\two text/html 2025-08-25T05:49:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:parsedate&rev=1756100953&do=diff Parses a date/time string to a date value, with controllable formatting. If the format argument is a string, it must be a valid date/time picture string (e.g. "dd/MM/yyyy"). Otherwise, format should be the sum of one or more of the following flag values: 1Use system locale format text/html 2023-08-08T05:51:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:pathtype&rev=1691473895&do=diff Returns the type of the specified path. Types are: filesysNormal filesystem path (e.g. C:\)shellNon-filesystem path like This PCcollFile collectionftpFTP pathlibLibrarymtpPortable device (phone, tablet)pluginPlugin filesystem (e.g. 7zip archive)zip text/html 2023-10-28T06:46:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:pow&rev=1698475605&do=diff Computes the value of raised to the power of . text/html 2023-10-28T06:48:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:radtodeg&rev=1698475685&do=diff Converts from radians to degrees. text/html 2025-05-08T05:25:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:recyclebin&rev=1746681946&do=diff With no arguments, returns true if the recycle bin is non-empty, or false if empty. If mode is set to "s", returns the size of the recycle bin in bytes. If mode is set to "c", returns the count of items in the recycle bin. If drive is specified, only information for that particular drive is returned. text/html 2026-02-04T17:44:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:regex&rev=1770227065&do=diff Performs a regular expression match against the provided string. The pattern must match the entire string exactly. To match on sub-strings instead, see RegExS. If a replace pattern is not specified, this function returns True if the provided string matches the text/html 2026-02-04T17:44:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:regexs&rev=1770227098&do=diff Performs a regular expression search in the provided string. The pattern does not need to match the whole string; a sub-string within the string may be matched instead. To match the entire string instead, see RegEx. If a replace pattern is not specified, this function returns text/html 2023-08-09T05:43:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:replace&rev=1691559803&do=diff Searches the input string for the search sub-string and replaces it with replace if found. Example: Output( Replace("Hello there!", "e", "a") ); --> hallo thara! text/html 2026-01-29T04:41:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:resolve&rev=1769661689&do=diff This function primarily resolves aliases and environment variables in the provided path (and with the "a" flag, paths are resolved to aliases). With the additional flags, it can also resolve the target of shortcuts, junctions and links. It can also be used to find a path's text/html 2023-08-20T01:42:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:reverse&rev=1692495742&do=diff Returns a reversed copy of string. Example: Output( Reverse("Hello World") ); --> dlroW olleH text/html 2023-08-09T05:06:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:right&rev=1691557564&do=diff Returns length characters from the right side of string. Example: Output( Right("Hello World", 5) ); --> World See also: Left Mid text/html 2024-07-25T05:37:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:rnd&rev=1721885848&do=diff Returns a random number between 0.0 and 1.0. text/html 2024-10-21T15:17:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:root&rev=1729523853&do=diff Returns the root of the specified path. On error, an empty string will be returned. If the path is already a root, it will be returned unchanged. Example: Output(Root("C:\one\two\file.jpg")); --> C:\ See also: FileExt FilePart Parent Stem text/html 2023-11-21T22:47:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:round&rev=1700606821&do=diff Rounds the input value to the nearest integer, or away from zero if equidistant. Example: Output( Round(1.4) + " " + Round(-1.5) + " " + Round(1.6) ); --> 1.000000 -2.000000 2.000000 See also: Ceil Floor text/html 2025-12-10T02:17:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:run&rev=1765333049&do=diff Runs a command. The command string can be any internal Opus command or external program, and and can consist of multiple lines (separated by CR/LF). The optional flags argument should be a string containing one or more of the following flags: aAsynchronous. Does not wait for the command to finish. text/html 2024-08-30T02:09:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:running&rev=1724983755&do=diff Queries whether a specified process is currently running. Example: if (Running("excel.exe")) { ... } // is Excel currently open? See also: FindWindow text/html 2023-08-09T05:09:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:select&rev=1691557765&do=diff Returns the value identified by the specified index. The index of the first item is 0. This performs an array-like function (the evaluator does not currently support arrays). Example: day = 3; Output(Select(day, "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")); --> Thu text/html 2025-08-25T04:54:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:setclip&rev=1756097644&do=diff Places the specific text on the clipboard. text/html 2023-10-28T06:47:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:sin&rev=1698475626&do=diff Computes the sine of (measured in radians). text/html 2023-08-09T04:54:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:space&rev=1691556841&do=diff Returns a string consisting of count spaces. Example: Output("Hello" + Space(10) + "World"); --> Hello World See also: String text/html 2023-10-28T06:47:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:sqrt&rev=1698475655&do=diff Computes the square root of . text/html 2023-08-09T04:52:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:stem&rev=1691556724&do=diff Returns the filename component of the specified path (or filename) with the file extension removed. Example: Output(Stem("C:\one\two\file.jpg")); --> file See also: FileExt FilePart Parent Root text/html 2023-08-09T05:03:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:strcmp&rev=1691557429&do=diff Compares two strings. While you can compare strings using the ==, < and > operators, using the StrCmp function lets you make the comparison case sensitive if desired. You can also choose the number of characters of each string to compare. Example: text/html 2023-08-09T05:06:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:string&rev=1691557575&do=diff Returns a string consisting of count copies of the character char. Example: Output(String(5, "A")); --> AAAAA See also: Space text/html 2023-08-09T04:49:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:swap&rev=1691556555&do=diff Swaps the values of the two variables. Example: i = "World"; j = "Hello"; Swap(i, j); Output( i + " " + j ); --> Hello World text/html 2025-07-23T05:38:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:sysinfo&rev=1753249083&do=diff Allows you to query the value of certain system properties. Example: if (SysInfo("MouseMonitor") == 0) { ... } // see if the mouse is on monitor 0 text/html 2025-08-25T05:37:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:tabpath&rev=1756100247&do=diff In the context of buttons and functions, returns the current path from a specified tab in the Lister. index is the tab index, and side should be one of the following characters to specify the file display: lleft/toprright/bottomssourceddestination If side isn't specified, the source file display is the default. text/html 2023-10-28T06:41:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:tan&rev=1698475269&do=diff Computes the tangent of (measured in radians). text/html 2023-08-09T04:45:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:trim&rev=1691556303&do=diff Trims leading and trailing spaces from string and returns the result. Example: Output( """" + Trim(" Hello World ") + """" ); --> "Hello World" text/html 2023-11-17T01:29:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:truncate&rev=1700184568&do=diff Truncates the string to the specified number of characters. If the truncation type isn't specified, the default is 2 if the input value is a path - otherwise the default is 0. If the input value is a path and middle truncation is selected, the function takes path separators into account correctly. text/html 2023-08-31T12:23:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:typeof&rev=1693484598&do=diff Returns a string indicating the type of the passed-in variable. Types are: bool, int, uint, int64, uint64, double, date, str, path and map. See the page on evaluator variables for information about the different types. Example: a = -5; Output( TypeOf(a) ); --> int text/html 2024-01-15T10:32:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:ucase&rev=1705314775&do=diff Returns string converted to upper-case. Example: Output( UCase("Hello World") ); --> HELLO WORLD See also: Capitalize LCase text/html 2023-08-09T05:47:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:urlencode&rev=1691560026&do=diff Encodes or decodes a string using URL-encoding. Example: Output( URLEncode("File Name") ); --> File%20Name Output( URLEncode("File Name", "g") ); -> File+Name Output( URLEncode("File%20Name", "d") ); -> File Name text/html 2025-05-08T05:15:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:evaluator:val&rev=1746681322&do=diff Returns the value of a variable; varname is provided as a quoted string. This is useful for variables which contain characters that would confuse the Evaluator's parser (e.g. if the name begins with a number). Example: flag = Val("35mmfocallength"); // get value of the 35mmfocallength field