| Magic File Renamer Help

Index > Reference > Formatting Parameters > General Group > Token

Description:
Extracts a token of any other format string. Source string is separated into tokens using a specified token separator string, and the specified token is extracted.
Signature:
`<token:token-number,token-separator,include-next,include-prev,source-format-string>`
Parameters:

Parameter | Description
`token-number` | Index of the token to extract. 1 is the first token. Must be below the total number of tokens is source string.
`token-separator` | Character or string to use in order to divide source string into tokens.
`include-next` | Extract all characters in the right part of the source string, starting from the speified token-number. (0=OFF, 1=ON)
`include-prev` | Extract all characters in the left part of the source string, until the speified token-number (including). (0=OFF, 1=ON)
`source-format-string` | String to extract token from. Must be Any other legal format string or literal.

Example:
For the item `C:\music\13_-_Smog_-_Cold_Blooded_Old_Times.mp3`

`<token:1,-,0,0,<full-name>>` | `13_`
`<token:2,_-_,0,0,<full-name>>` | `Smog`
`<token:2,_-_,1,0,<full-name>>` | `Smog_-_Cold_Blooded_Old_Times.mp3`