• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • kdecore
 

kdecore

Public Member Functions | Protected Member Functions
KMacroExpanderBase Class Reference

#include <kmacroexpander.h>

Inheritance diagram for KMacroExpanderBase:
KCharMacroExpander KWordMacroExpander

List of all members.

Public Member Functions

 KMacroExpanderBase (TQChar c= '%')
virtual ~KMacroExpanderBase ()
void expandMacros (TQString &str)
bool expandMacrosShellQuote (TQString &str, uint &pos)
bool expandMacrosShellQuote (TQString &str)
void setEscapeChar (TQChar c)
TQChar escapeChar () const

Protected Member Functions

virtual int expandPlainMacro (const TQString &str, uint pos, TQStringList &ret)
virtual int expandEscapedMacro (const TQString &str, uint pos, TQStringList &ret)

Detailed Description

Abstract base class for the worker classes behind the KMacroExpander namespace and the KCharMacroExpander and KWordMacroExpander classes.

Since:
3.1.3
Author:
Oswald Buddenhagen <ossi@kde.org>

Definition at line 37 of file kmacroexpander.h.


Constructor & Destructor Documentation

KMacroExpanderBase::KMacroExpanderBase ( TQChar  c = '%')

Constructor.

Parameters:
cescape char indicating start of macros, or TQChar::null for none

Definition at line 28 of file kmacroexpander.cpp.

KMacroExpanderBase::~KMacroExpanderBase ( ) [virtual]

Destructor.

Definition at line 33 of file kmacroexpander.cpp.


Member Function Documentation

TQChar KMacroExpanderBase::escapeChar ( ) const

Obtain the macro escape character.

Returns:
escape char indicating start of macros, or TQChar::null if none

Definition at line 44 of file kmacroexpander.cpp.

int KMacroExpanderBase::expandEscapedMacro ( const TQString &  str,
uint  pos,
TQStringList &  ret 
) [protected, virtual]

This function is called every time the escape char is found if it is not TQChar::null.

It should determine whether the string starting at pos witin str is a valid macro and return the substitution value for it if so.

Parameters:
strthe input string
posthe offset within str. Note that this is the position of the occurrence of the escape char
retreturn value: the string to substitute for the macro
Returns:
if greater than zero, the number of chars at pos in str to substitute with ret (i.e., a valid macro was found). if less than zero, subtract this value from pos (to skip a macro, i.e., substitute it with itself). zero requests no special action.

Reimplemented in KCharMacroExpander, and KWordMacroExpander.

Definition at line 290 of file kmacroexpander.cpp.

void KMacroExpanderBase::expandMacros ( TQString &  str)

Perform safe macro expansion (substitution) on a string.

Parameters:
strthe string in which macros are expanded in-place

Definition at line 49 of file kmacroexpander.cpp.

bool KMacroExpanderBase::expandMacrosShellQuote ( TQString &  str)

Same as above, but always starts at position 0, and unmatched closing parens and braces are treated as errors.

Definition at line 281 of file kmacroexpander.cpp.

int KMacroExpanderBase::expandPlainMacro ( const TQString &  str,
uint  pos,
TQStringList &  ret 
) [protected, virtual]

This function is called for every single char within the string if the escape char is TQChar::null.

It should determine whether the string starting at pos within str is a valid macro and return the substitution value for it if so.

Parameters:
strthe input string
posthe offset within str
retreturn value: the string to substitute for the macro
Returns:
if greater than zero, the number of chars at pos in str to substitute with ret (i.e., a valid macro was found). if less than zero, subtract this value from pos (to skip a macro, i.e., substitute it with itself). zero requests no special action.

Reimplemented in KCharMacroExpander, and KWordMacroExpander.

Definition at line 287 of file kmacroexpander.cpp.

void KMacroExpanderBase::setEscapeChar ( TQChar  c)

Set the macro escape character.

Parameters:
cescape char indicating start of macros, or TQChar::null if none

Definition at line 38 of file kmacroexpander.cpp.


The documentation for this class was generated from the following files:
  • kmacroexpander.h
  • kmacroexpander.cpp

kdecore

Skip menu "kdecore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdecore

Skip menu "kdecore"
  • arts
  • dcop
  • dnssd
  • interfaces
  •     interface
  •     library
  •   kspeech
  •   ktexteditor
  • kabc
  • kate
  • kcmshell
  • kdecore
  • kded
  • kdefx
  • kdeprint
  • kdesu
  • kdeui
  • kdoctools
  • khtml
  • kimgio
  • kinit
  • kio
  •   bookmarks
  •   httpfilter
  •   kfile
  •   kio
  •   kioexec
  •   kpasswdserver
  •   kssl
  • kioslave
  •   http
  • kjs
  • kmdi
  •   kmdi
  • knewstuff
  • kparts
  • krandr
  • kresources
  • kspell2
  • kunittest
  • kutils
  • kwallet
  • libkmid
  • libkscreensaver
Generated for kdecore by doxygen 1.7.6.1
This website is maintained by Timothy Pearson.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. |