Gets the value corresponding to a particular item as a number. This number will be an integer if it can be, but otherwise a floating point number. The first parameter is the group name, the second parameter is the item name and the final parameter is the default value. In the event that the item does not exist, the default value is used. The default value is always returned as a float.
Gets the value corresponding to a particular item as a string. The first parameter is the group name, the second is the item name and the final parameter is the default value. In the case that the item does not exist, the default value is used. The string might not be returned in exactly the same manor that it is scored in the file. For instance, escape characters will be replaced with the characters they represent and quotes may be removed.
The first and second parameters determine the group and item to read respectively. This expression applies to items formatted in the manor “number1, number2”. This expression returns, as an integer, ‘number1’. If it does not exist, a default value of 0 is used.
The first and second parameters determine the group and item to read respectively. This expression applies to items formatted in the manor “number1, number2”. This expression returns, as an integer, ‘number2’. If it does not exist, a default value of 0 is used.
TThis action receives as a string the text which would be saved to file by the ‘Save’ command. Encryption and compression is not applied, however.
This action receives as a string the text which would be saved to file by the ‘Import/Export as CSV’ command.
The expressions in this section are similar to those listed above, but apply only to the current group.
This expression lists all the group names in the object in alphabetical order. The parameter is which number group is to be returned. The first group is either 0 or 1 depending on the settings in the property pane. Use the ‘Get Group Count’ expression to find out how many groups there are. Any value of range will just return a blank string.
This expression lists all the item names in the object in alphabetical order. The first parameter specifies the group to look in and the second parameter is which number item is to be returned. The first item is either 0 or 1 depending on the settings in the property pane. Use the ‘Get Item Count’ expression to find out how many items there are in a particular group. Any value of range will just return a blank string.
This expression gives the value associated with the n-th item in a list, by the ordering of th ‘Get N-th Item name’ expression (which orders by key name alphabetically). The first parameter specifies the group to look in and the second parameter is which number item is to be returned. The first item is either 0 or 1 depending on the settings in the property pane.
This expression gives the value associated with the n-th item in a list, by the ordering of th ‘Get N-th Item name’ expression (which orders by key name alphabetically). The value is converting to a number (integer if possible, otherwise floating point). The first parameter specifies the group to look in and the second parameter is which number item is to be returned. The first item is either 0 or 1 depending on the settings in the property pane.
This action is as ‘Get N-th Item name’, but the ordering is alphabetical on the values, not on the item names. The first parameter specifies the group to look in and the second parameter is which number item is to be returned. The first item is either 0 or 1 depending on the settings in the property pane. Use the ‘Get Item Count’ expression to find out how many items there are in a particular group. Any value of range will just return a blank string.
This action is as ‘Get N-th Item value’, but the ordering is alphabetical on the values, not on the item names. The value is returned as an integer if possible but a floating point otherwise. The first parameter specifies the group to look in and the second parameter is which number item is to be returned. The first item is either 0 or 1 depending on the settings in the property pane. Use the ‘Get Item Count’ expression to find out how many items there are in a particular group. Any value of range will just return a blank string.
This expression allows all items to be iterated through, regardless of group. It returns the item names. Items are not repeated. For instance, the Ini file:
Then the list would be: ‘Bob’, ‘Ted’, ‘John’. The ‘Get number of unique item names’ expression can be used to find out how many item names there are. This expression respects the ‘1 based index’ option. A blank string is returned out of range.
Returns the number of groups in the object. This includes empty groups if ‘Allow empty groups’ is enabled.
Returns the number of items in the specified group.
Returns the total number of items in any group (including items with the same name but in different groups).
Returns the number of unique item names in the object. Useful with the ‘Get N-th Item used in any group’ expression.
This expression is a bit more complicated than the others. The idea of the expression is to get data from the object by performing a calculation on each group, and then performing a calculation to combine all these numbers. For instance, we might find the average of every group and then take the product of all those averages. (Why you might want to do that is not obvious, but you can if you wish!) It is best shown by examples. For instance, suppose you had the following file (of Arsenal’s record against various teams since the war):
Suppose we wish to know how many matches there have been in total against these sides. This is easy with this expression. Setting the second parameter to ‘+’ will cause each group to be added up. Then we have the following values associated with each group: Bradford City, 24; Ajax: 4; Barcelona: 5; Wimbledon: 28. We obviously wish these values to be added up, so for the first parameter we choose ‘+’ and then the expression returns 24+4+5+28 = 61. Now instead, suppose we wish to know the total number of games draw against each of these teams. To do that we just want to pick out the draws, so for the second parameter we just write ‘Draw’. We then have the following values associated with each group: Bradford City, 5; Ajax: 0; Barcelona: 1; Wimbledon: 8. For the first parameter we write ‘+’ again, and so the expression returns 14. If you just wanted to sum the number of games against Ajax, you can write ‘Ajax’ for the first parameter and ‘+’ for the second parameter. It will then return 4. The full table of operators are:
The following are some general examples:
This expression works very similarly to “Perform Calculations”. The items in each group are combined according to the second parameter, which may be any of the operators which were valid for the “Perform Calculations” expression. However, instead of combining these group values together, this expression returns the name of the group associated with either the maximum or minimum value. Therefore the first parameter may be only ‘Max’ or ‘Min’. In the example from the “Perform Calculations” section, we could use this expression with first parameter ‘Max’ and second parameter ‘Win’ to find out the name of the team Arsenal had beaten the most (Wimbledon).
This expression returns the number of search results.
This expression returns the group name of the nth search result.
This expression returns the item name of the nth search result.
This expression returns the value of the nth search result, converted to a number.
This expression returns the value of the nth search result.
This expression returns a string which is the group name, followed by the separator character, followed by the item name.
Returns the hash of the specified string.
This expression replaces ‘\’ with ‘\\’, quotes with ‘\q’, tabs with ‘\t’ and newlines with ‘\n’. Newlines are whatever the new line character is in the object settings.
This expression replaces ‘\\’ with ‘\’, ‘\q’ with quotes, ‘\t’ with tabs, ‘\n’ with newlines and ‘\ ’ with spaces.