KMacroExpander Namespace Reference
Detailed Description
A group of functions providing macro expansion (substitution) in strings, optionally with quoting appropriate for shell execution.
- Since:
- 3.1.3
Enumerations | |
enum | Quoting { noquote, singlequote, doublequote, dollarquote, paren, subst, group, math } |
Functions | |
QString | expandMacros (const QString &str, const QMap< QChar, QString > &map, QChar c= '%') |
QString | expandMacrosShellQuote (const QString &str, const QMap< QChar, QString > &map, QChar c= '%') |
QString | expandMacros (const QString &str, const QMap< QString, QString > &map, QChar c= '%') |
QString | expandMacrosShellQuote (const QString &str, const QMap< QString, QString > &map, QChar c= '%') |
QString | expandMacros (const QString &str, const QMap< QChar, QStringList > &map, QChar c= '%') |
QString | expandMacrosShellQuote (const QString &str, const QMap< QChar, QStringList > &map, QChar c= '%') |
QString | expandMacros (const QString &str, const QMap< QString, QStringList > &map, QChar c= '%') |
QString | expandMacrosShellQuote (const QString &str, const QMap< QString, QStringList > &map, QChar c= '%') |
Enumeration Type Documentation
|
Definition at line 85 of file kmacroexpander.cpp. |
Function Documentation
|
Same as above, except that the macros expand to string lists that are simply join(" ")ed together.
Definition at line 526 of file kmacroexpander.cpp. |
|
Same as above, except that the macros expand to string lists that are simply join(" ")ed together.
Definition at line 524 of file kmacroexpander.cpp. |
|
Perform safe macro expansion (substitution) on a string. The escape char must be quoted with itself to obtain its literal representation in the resulting string. Macro names can consist of chars in the range [A-Za-z0-9_]; use braces to delimit macros from following words starting with these chars, or to use other chars for macro names.
// Code example QMap<QString,QString> map; map.insert("url", "/tmp/myfile.txt"); map.insert("name", "My File"); QString s = "Title: %{url}-%name"; s = KMacroExpander::expandMacros(s, map); // s is now "Title: /tmp/myfile.txt-My File"; Definition at line 522 of file kmacroexpander.cpp. |
|
Perform safe macro expansion (substitution) on a string. The escape char must be quoted with itself to obtain its literal representation in the resulting string.
// Code example QMap<QChar,QString> map; map.insert('u', "/tmp/myfile.txt"); map.insert('n', "My File"); QString s = "%% Title: %u:%n"; s = KMacroExpander::expandMacros(s, map); // s is now "% Title: /tmp/myfile.txt:My File"; Definition at line 520 of file kmacroexpander.cpp. |
|
Same as above, except that the macros expand to string lists. If the macro appears inside a quoted string, the list is simply join(" ")ed together; otherwise every element expands to a separate quoted string. Definition at line 527 of file kmacroexpander.cpp. |
|
Same as above, except that the macros expand to string lists. If the macro appears inside a quoted string, the list is simply join(" ")ed together; otherwise every element expands to a separate quoted string. Definition at line 525 of file kmacroexpander.cpp. |
|
Perform safe macro expansion (substitution) on a string for use in shell commands. The escape char must be quoted with itself to obtain its literal representation in the resulting string. Macro names can consist of chars in the range [A-Za-z0-9_]; use braces to delimit macros from following words starting with these chars, or to use other chars for macro names.
// Code example QMap<QString,QString> map; map.insert("url", "/tmp/myfile.txt"); map.insert("name", "My File"); QString s = "kedit --caption %name %{url}"; s = KMacroExpander::expandMacrosShellQuote(s, map); // s is now "kedit --caption 'My File' '/tmp/myfile.txt'"; system(QFile::encodeName(s)); Definition at line 523 of file kmacroexpander.cpp. |
|
Perform safe macro expansion (substitution) on a string for use in shell commands. The escape char must be quoted with itself to obtain its literal representation in the resulting string.
// Code example QMap<QChar,QString> map; map.insert('u', "/tmp/myfile.txt"); map.insert('n', "My File"); QString s = "kedit --caption %n %u"; s = KMacroExpander::expandMacrosShellQuote(s, map); // s is now "kedit --caption 'My File' '/tmp/myfile.txt'"; system(QFile::encodeName(s)); Definition at line 521 of file kmacroexpander.cpp. |