(v6.80.0114, 17-mar-2008).
Code: Select all
v6.80.0114 - 2008-03-17 12:29
+ Scripting got new commands:
- StrLen
Action: Returns the length of a string.
Syntax: StrLen OutputVar, String
Examples:
::strlen $a, "abcdef"; // 6
::strlen $a, <curitem>; // length of current item
- StrPos
Action: Returns position of first occurrence of a string.
Syntax: StrPos OutputVar, Haystack, Needle, [Start],
[MatchCase]
- OutputVar: Required, anything goes, case matters.
- Haystack: String to search in.
- Needle: String to search for.
- Start: [optional; defaults to 0] Allows you to specify
which position in haystack to start searching. The position
returned is still relative to the beginning of haystack.
- MatchCase: [optional; defaults to 0] Compare method.
0: A=a
1: A<>a
Examples:
::strpos $a, "abcabc", "a"; // returns 0
::strpos $a, "abcabc", "d"; // returns -1 (not found)
::strpos $a, "abcAbc", "A"; // returns 0
::strpos $a, "abcAbc", "A", , 1; // returns 3
::strpos $a, "abcAbc", "a", 1; // returns 3
::strpos $a, "abcAbc", "a", 10; // returns -1 (not found)
::strpos $a, "abcAbc", ""; // returns -1 (not found)
::strpos $a, "", "a"; // returns -1 (not found)
::strpos $a, "", ""; // returns -1 (not found)
- Incr
Action: Increment a numerical value.
Syntax: Incr OutputVar, [Value], [Increment=1]
- OutputVar: Required, anything goes, case matters.
- Value: Value defaults to OutputVar(!); can be negative.
- Increment: Defaults to 1; can be negative.
Examples:
::incr $a; // returns $a + 1
::set $a, 5; incr $a; // returns 6 (5 + 1)
::incr $a, 1; // returns 2 (1 + 1)
::incr $a, 1, 2; // returns 3 (1 + 2)
::incr $a, -1, 2; // returns 1 (-1 + 2)
::incr $a, 1, -2; // returns -1 (1 - 2)
::incr $a, -1, -2; // returns -3 (-1 - 2)
::incr $a, "Paul"; // returns 1 (0 + 1)
::incr $a, "3Paul"; // returns 4 (3 + 1)
* Scripting: Renamed "Add" renamed to "AddStr". Reason: "Add"
implies a numerical operation.
* Scripting: Renamed "Mid" to "SubStr". Also changed its syntax as
to match SubStr in PHP. So forget yesterday's "Mid", here's
"SubStr":
- SubStr
Action: returns part of a string
Syntax: SubStr OutputVar, String, [Start], [Length]
- OutputVar: Required, anything goes, case matters.
- String: Input string.
- Start: Start of returned part; defaults to 0, first
position is 0. If Start is negative, the returned string will
start at the start'th character from the end of string.
- Length: Length of returned part (number of characters).
If missing then the whole string is returned (beginning from
Start). If Length is negative, then that many characters
will be omitted from the end of string (after the start
position has been calculated when Start is negative). If
Start denotes a position beyond this truncation, an empty
string will be returned.
Examples:
::substr $a, "abcdef", 1; // returns "bcdef"
::substr $a, "abcdef", 1, 1; // returns "b"
::substr $a, "abcdef", -1); // returns "f"
::substr $a, "abcdef", -2); // returns "ef"
::substr $a, "abcdef", -3, 1); // returns "d"
::substr $a, "abcdef", 0, -1); // returns "abcde"
::substr $a, "abcdef", 2, -1); // returns "cde"
::substr $a, "abcdef", 4, -4); // returns ""
::substr $a, "abcdef", -3, -1); // returns "de"
+ New variable: <focitem> = currently focused item in tree or list.
Useful in scripting; for example, this works in tree or list
depending on focus:
::copytext <focitem>
Note that, contrary to <curitem>, <focitem> will also return the
focused item if it is not selected.
* Scripting | RegExReplace: Now caret (^) & dollar ($) match the
beginning & end of every line, before they'd only match the very
start and very end of the entire string.
XYplorer Beta Club