This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
Tokens [2016/12/02 04:43] peternlewis |
Tokens [2019/09/20 14:32] JMichaelTX |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:token-icon.png?nolink|}} | ||
====== Tokens ====== | ====== Tokens ====== | ||
===== Definition ===== | ===== Definition ===== | ||
- | **Tokens in Keyboard Maestro represent placeholders for information about a specific object.** For example, the [[token:SafariTitle|%SafariTitle% token]] returns the title of the current Safari tab. So the value of the Token will be determined at execution time. All tokens return a text value, even if the source data was some other data type. | + | **Tokens in Keyboard Maestro represent placeholders for information that will replace it in the text.** For example, the [[token:SafariTitle|%SafariTitle% token]] returns the title of the current Safari tab. So the value of the Token will be determined at execution time. All tokens return a text value, even if the source data was some other data type. |
Tokens allow you to add textual information to [[/Text_Fields|token text fields]]. You can insert tokens into a field using the Insert Token popup near the field or by choosing [[manual:Menus#Edit_Insert_Token|Insert Token]] from the [[manual:Menus#Edit|Edit menu]]. You can also start typing a token and use text completion to complete the token. | Tokens allow you to add textual information to [[/Text_Fields|token text fields]]. You can insert tokens into a field using the Insert Token popup near the field or by choosing [[manual:Menus#Edit_Insert_Token|Insert Token]] from the [[manual:Menus#Edit|Edit menu]]. You can also start typing a token and use text completion to complete the token. | ||
- | Text token fields also process %NN% or %NNNN% as arbitrary hex unicode characters (eg %41% is an A), and (except for regular expression fields) process backslashed characters \a,\b,\e,\f,\t,\r,\n (bell,backspace,escape,form feed,tab,return,line feed). | + | ===== Text Processing ===== |
+ | |||
+ | You can use the following special formats to process text or to return non-printing characters: | ||
+ | - **Convert Case of Text** | ||
+ | * Use these special characters: `\U \L \E \u \l` | ||
+ | * For details, see [[manual:Tokens#Text_Case_Conversions|Text Case Conversions]] | ||
+ | - **Return Non-Printing Characters** | ||
+ | * **Convert**: ` \a \b \e \f \t \r \n` \\ **To**:` `bell, backspace, escape, form feed, tab, return, line feed. | ||
+ | - **Convert Hex Code to Unicode Characters** | ||
+ | * Enter Hex Codes in this format: `%NN%` or `%NNNN%` | ||
+ | - **Escape Special Characters** | ||
+ | * Use `%%` to return a single `%` as plain text | ||
+ | * Use `\\` to return a single `\` as plain text | ||
- | To include a percent in your text, simply double the percent. To include a backslash in your text, double the backslash. | ||