<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>kdecore: KStringHandler Class Reference (kdecore)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
/ <a href=".">kdecore</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
</div>
<div class="header">
<div class="summary">
<a href="#pub-static-methods">Static Public Member Functions</a> </div>
<div class="headertitle">
<div class="title">KStringHandler Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="KStringHandler" -->
<p>This class contains utility functions for handling strings.
<a href="classKStringHandler.html#details">More...</a></p>
<p><code>#include <<a class="el" href="kstringhandler_8h_source.html">kstringhandler.h</a>></code></p>
<p><a href="classKStringHandler-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a627e4dbdcb613391162bbbb91d478fbe">word</a> (const <a class="elRef" href="qstring.html">QString</a> &text, uint pos) KDE_DEPRECATED</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a98cf14bc638e296c10af75bc71b6174e">word</a> (const <a class="elRef" href="qstring.html">QString</a> &text, const char *range)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a018aa3605609daa7c194c4503c063fb7">insword</a> (const <a class="elRef" href="qstring.html">QString</a> &text, const <a class="elRef" href="qstring.html">QString</a> &word, uint pos)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a748663a8c291be9c7c7e90430ec99865">setword</a> (const <a class="elRef" href="qstring.html">QString</a> &text, const <a class="elRef" href="qstring.html">QString</a> &word, uint pos)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a7eff79b23f4c25b8052dd4198c2608d5">remrange</a> (const <a class="elRef" href="qstring.html">QString</a> &text, const char *range)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a6023d8f88fb09854c27d279c090bd72c">remword</a> (const <a class="elRef" href="qstring.html">QString</a> &text, uint pos)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#af969364f3569bab1beaa6e1054c07001">remword</a> (const <a class="elRef" href="qstring.html">QString</a> &text, const <a class="elRef" href="qstring.html">QString</a> &word)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#af9182d35f0232e42079bc319def02c74">capwords</a> (const <a class="elRef" href="qstring.html">QString</a> &text)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#aacf38a42b22df2959ff668d31a1614c3">capwords</a> (const <a class="elRef" href="qstringlist.html">QStringList</a> &list)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#ad9ede746249d19a868ef81ba6b032b02">reverse</a> (const <a class="elRef" href="qstring.html">QString</a> &text)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a9bf062c35878a3e92d14335368f96140">reverse</a> (const <a class="elRef" href="qstringlist.html">QStringList</a> &list)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#ad26b644bf1ad88cf465283c0aeb2334a">ljust</a> (const <a class="elRef" href="qstring.html">QString</a> &text, uint width) KDE_DEPRECATED</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a1b7826f8f5537993b93dfe4711a73338">rjust</a> (const <a class="elRef" href="qstring.html">QString</a> &text, uint width) KDE_DEPRECATED</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a22350690e912f8f7039a3bcb7d15d464">center</a> (const <a class="elRef" href="qstring.html">QString</a> &text, uint width)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a5208dfe3d289f1e154a147e5369bab84">lsqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &str, uint maxlen=40)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a2a34eed17945a4657fdb8142afbadfd0">lEmSqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &name, const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> &fontMetrics, uint maxlen=30)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a0c9be5a11fd02060df3d9716bedc94e2">lPixelSqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &name, const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> &fontMetrics, uint maxPixels)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a5d09c657585f2b3443e5af9e8a1fbef7">csqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &str, uint maxlen=40)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a331a456c777773d1c13bcce5f8609946">cEmSqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &name, const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> &fontMetrics, uint maxlen=30)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a618e057abbf7ae2304566e5194591f7a">cPixelSqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &name, const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> &fontMetrics, uint maxPixels)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#aa1e2df6c9fb0aaf9cc6b698035bfc6ac">rsqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &str, uint maxlen=40)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a3623e50903c09f16dbcd0b6ca9e3437e">rEmSqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &name, const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> &fontMetrics, uint maxlen=30)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a144f69f4e94df326c7bf90c2defb3fa3">rPixelSqueeze</a> (const <a class="elRef" href="qstring.html">QString</a> &name, const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> &fontMetrics, uint maxPixels)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a4b8d4bdb6fdb20ae82b2b527a9b0234e">matchFileName</a> (const <a class="elRef" href="qstring.html">QString</a> &filename, const <a class="elRef" href="qstring.html">QString</a> &pattern)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a85cadf984ec2e4d3f80c17581a30e329">perlSplit</a> (const <a class="elRef" href="qstring.html">QString</a> &sep, const <a class="elRef" href="qstring.html">QString</a> &s, uint max=0)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#ac616012c361a9a94d950b3b8228cbb8f">perlSplit</a> (const <a class="elRef" href="qchar.html">QChar</a> &sep, const <a class="elRef" href="qstring.html">QString</a> &s, uint max=0)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a117f94c205118617b8b8b975e1b0f8c2">perlSplit</a> (const <a class="elRef" href="qregexp.html">QRegExp</a> &sep, const <a class="elRef" href="qstring.html">QString</a> &s, uint max=0)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#affded06be9938cacf7431ca9bd4f8d35">tagURLs</a> (const <a class="elRef" href="qstring.html">QString</a> &text)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#afa464f27b952f544619fd2059eab80b0">obscure</a> (const <a class="elRef" href="qstring.html">QString</a> &str)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a91d20757430cf64f7703935a1a57b7d6">isUtf8</a> (const char *str)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a47e67c7f87de83c70a758ac72dda01f0">from8Bit</a> (const char *str)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static KDE_DEPRECATED bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStringHandler.html#a6311e620cda65df2aeeb2344d20aa010">matchFilename</a> (const <a class="elRef" href="qstring.html">QString</a> &filename, const <a class="elRef" href="qstring.html">QString</a> &pattern)</td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>This class contains utility functions for handling strings. </p>
<p>This class is <em>not</em> a substitute for the <a class="elRef" href="qstring.html">QString</a> class. What I tried to do with this class is provide an easy way to cut/slice/splice words inside sentences in whatever order desired. While the main focus of this class are words (ie characters separated by spaces/tabs), the two core functions here ( split() and join() ) will function given any char to use as a separator. This will make it easy to redefine what a 'word' means in the future if needed.</p>
<p>I freely stole some of the function names from python. I also think some of these were influenced by mIRC (yes, believe it if you will, I used to write a LOT of scripts in mIRC).</p>
<p>The ranges are a fairly powerful way of getting/stripping words from a string. These ranges function, for the large part, as they would in python. See the <a class="el" href="classKStringHandler.html#a98cf14bc638e296c10af75bc71b6174e" title="Returns a range of words from that string.">word(const QString&, const char *)</a> and <a class="el" href="classKStringHandler.html#a6023d8f88fb09854c27d279c090bd72c" title="Removes a word at the given index, and returns a new string.">remword(const QString&, uint)</a> functions for more detail.</p>
<p>This class contains no data members of its own. All strings are cut on the fly and returned as new qstrings/qstringlists.</p>
<p>Quick example on how to use:</p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classKStringHandler.html" title="This class contains utility functions for handling strings.">KStringHandler</a> kstr;
<a class="codeRef" href="qstring.html">QString</a> line = <span class="stringliteral">"This is a test of the strings"</span>;
cout << <span class="stringliteral">"1> "</span> << kstr.<a class="code" href="classKStringHandler.html#a627e4dbdcb613391162bbbb91d478fbe" title="Returns the nth word in the string if found Returns a EMPTY (not null) string otherwise.">word</a>( line , <span class="stringliteral">"4:"</span> ) << <span class="stringliteral">"\n"</span>;
cout << <span class="stringliteral">"2> "</span> << kstr.<a class="code" href="classKStringHandler.html#a7eff79b23f4c25b8052dd4198c2608d5" title="Removes a word or ranges of words from the string, and returns a new string.">remrange</a>( line , <span class="stringliteral">"2:5"</span> ) << <span class="stringliteral">"\n"</span>;
cout << <span class="stringliteral">"2> "</span> << kstr.<a class="code" href="classKStringHandler.html#ad9ede746249d19a868ef81ba6b032b02" title="Reverses the order of the words in a string "hello there" becomes "there hello" (string)">reverse</a>( line ) << <span class="stringliteral">"\n"</span>;
cout << <span class="stringliteral">"2> "</span> << kstr.<a class="code" href="classKStringHandler.html#a22350690e912f8f7039a3bcb7d15d464" title="Centers a string and returns a string at least 'width' characters wide.">center</a>( kstr.<a class="code" href="classKStringHandler.html#a627e4dbdcb613391162bbbb91d478fbe" title="Returns the nth word in the string if found Returns a EMPTY (not null) string otherwise.">word</a>( line , 4 ) , 15 ) << <span class="stringliteral">"\n"</span>;
</pre></div><p>and so forth.</p>
<p>Class for manipulating words and sentences in strings </p>
<dl class="author"><dt><b>Author:</b></dt><dd>Ian Zepp <<a href="mailto:icszepp@islc.net">icszepp@islc.net</a>> </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="namespaceKShell.html" title="Provides some basic POSIX shell and bash functionality.">KShell</a> </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8h_source.html#l00069">69</a> of file <a class="el" href="kstringhandler_8h_source.html">kstringhandler.h</a>.</p>
</div><hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="af9182d35f0232e42079bc319def02c74"></a><!-- doxytag: member="KStringHandler::capwords" ref="af9182d35f0232e42079bc319def02c74" args="(const QString &text)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::capwords </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Capitalizes each word in the string "hello there" becomes "Hello There" (string) </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the text to capitalize </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00193">193</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aacf38a42b22df2959ff668d31a1614c3"></a><!-- doxytag: member="KStringHandler::capwords" ref="aacf38a42b22df2959ff668d31a1614c3" args="(const QStringList &list)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStringHandler::capwords </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>list</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Capitalizes each word in the list [hello, there] becomes [Hello, There] (list) </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">list</td><td>the list to capitalize </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting list </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00207">207</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a331a456c777773d1c13bcce5f8609946"></a><!-- doxytag: member="KStringHandler::cEmSqueeze" ref="a331a456c777773d1c13bcce5f8609946" args="(const QString &name, const QFontMetrics &fontMetrics, uint maxlen=30)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::cEmSqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> & </td>
<td class="paramname"><em>fontMetrics</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxlen</em> = <code>30</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters in the middle of a string by "...". </p>
<p>Similar to method above, except that it truncates based on pixel width rather than the number of characters </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>is the string to modify </td></tr>
<tr><td class="paramname">fontMetrics</td><td>is the font metrics to use to calculate character sizes </td></tr>
<tr><td class="paramname">maxlen</td><td>is the maximum length in ems the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00333">333</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a22350690e912f8f7039a3bcb7d15d464"></a><!-- doxytag: member="KStringHandler::center" ref="a22350690e912f8f7039a3bcb7d15d464" args="(const QString &text, uint width)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::center </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>width</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Centers a string and returns a string at least 'width' characters wide. </p>
<p>If the string is longer than the <code>width</code>, the original string is returned. It is never truncated. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the text to justify </td></tr>
<tr><td class="paramname">width</td><td>the desired width of the new string </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00261">261</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a618e057abbf7ae2304566e5194591f7a"></a><!-- doxytag: member="KStringHandler::cPixelSqueeze" ref="a618e057abbf7ae2304566e5194591f7a" args="(const QString &name, const QFontMetrics &fontMetrics, uint maxPixels)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::cPixelSqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> & </td>
<td class="paramname"><em>fontMetrics</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxPixels</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters in the middle of a string by "...". </p>
<p>Similar to method above, except that maxlen is the width in pixels to truncate to </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>is the string to modify </td></tr>
<tr><td class="paramname">fontMetrics</td><td>is the font metrics to use to calculate character sizes </td></tr>
<tr><td class="paramname">maxPixels</td><td>is the maximum pixel length the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00338">338</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a5d09c657585f2b3443e5af9e8a1fbef7"></a><!-- doxytag: member="KStringHandler::csqueeze" ref="a5d09c657585f2b3443e5af9e8a1fbef7" args="(const QString &str, uint maxlen=40)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::csqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxlen</em> = <code>40</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the middle of a string by "...". </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>is the string to modify </td></tr>
<tr><td class="paramname">maxlen</td><td>is the maximum length the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00285">285</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a47e67c7f87de83c70a758ac72dda01f0"></a><!-- doxytag: member="KStringHandler::from8Bit" ref="a47e67c7f87de83c70a758ac72dda01f0" args="(const char *str)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::from8Bit </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>str</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Construct <a class="elRef" href="qstring.html">QString</a> from a c string, guessing whether it is UTF8- or Local8Bit-encoded. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>the input string </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the (hopefully correctly guessed) <a class="elRef" href="qstring.html">QString</a> representation of <code>str</code> </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00652">652</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a018aa3605609daa7c194c4503c063fb7"></a><!-- doxytag: member="KStringHandler::insword" ref="a018aa3605609daa7c194c4503c063fb7" args="(const QString &text, const QString &word, uint pos)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::insword </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>word</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>pos</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Inserts a word into the string, and returns a new string with the word included. </p>
<p>the first index is zero (0). If there are not <code>pos</code> words in the original string, the new word will be appended to the end. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the original text </td></tr>
<tr><td class="paramname">word</td><td>the word to insert </td></tr>
<tr><td class="paramname">pos</td><td>the position (in words) for the new word </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00080">80</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a91d20757430cf64f7703935a1a57b7d6"></a><!-- doxytag: member="KStringHandler::isUtf8" ref="a91d20757430cf64f7703935a1a57b7d6" args="(const char *str)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStringHandler::isUtf8 </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>str</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Guess whether a string is UTF8 encoded. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>the string to check </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if UTF8. If false, the string is probably in Local8Bit. </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00567">567</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a2a34eed17945a4657fdb8142afbadfd0"></a><!-- doxytag: member="KStringHandler::lEmSqueeze" ref="a2a34eed17945a4657fdb8142afbadfd0" args="(const QString &name, const QFontMetrics &fontMetrics, uint maxlen=30)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::lEmSqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> & </td>
<td class="paramname"><em>fontMetrics</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxlen</em> = <code>30</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the beginning of a string by "...". </p>
<p>Similar to method above, except that it truncates based on pixel width rather than the number of characters </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>is the string to modify </td></tr>
<tr><td class="paramname">fontMetrics</td><td>is the font metrics to use to calculate character sizes </td></tr>
<tr><td class="paramname">maxlen</td><td>is the maximum length in ems the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00303">303</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ad26b644bf1ad88cf465283c0aeb2334a"></a><!-- doxytag: member="KStringHandler::ljust" ref="ad26b644bf1ad88cf465283c0aeb2334a" args="(const QString &text, uint width) KDE_DEPRECATED" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::ljust </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>width</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Left-justifies a string and returns a string at least 'width' characters wide. </p>
<p>If the string is longer than the <code>width</code>, the original string is returned. It is never truncated. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the text to justify </td></tr>
<tr><td class="paramname">width</td><td>the desired width of the new string </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000061">Deprecated:</a></b></dt><dd>use <a class="elRef" href="qstring.html#leftJustify">QString::leftJustify</a> instead </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00251">251</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a0c9be5a11fd02060df3d9716bedc94e2"></a><!-- doxytag: member="KStringHandler::lPixelSqueeze" ref="a0c9be5a11fd02060df3d9716bedc94e2" args="(const QString &name, const QFontMetrics &fontMetrics, uint maxPixels)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::lPixelSqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> & </td>
<td class="paramname"><em>fontMetrics</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxPixels</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the beginning of a string by "...". </p>
<p>Similar to method above, except that maxlen is the width in pixels to truncate to </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>is the string to modify </td></tr>
<tr><td class="paramname">fontMetrics</td><td>is the font metrics to use to calculate character sizes </td></tr>
<tr><td class="paramname">maxPixels</td><td>is the maximum pixel length the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00308">308</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a5208dfe3d289f1e154a147e5369bab84"></a><!-- doxytag: member="KStringHandler::lsqueeze" ref="a5208dfe3d289f1e154a147e5369bab84" args="(const QString &str, uint maxlen=40)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::lsqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxlen</em> = <code>40</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the beginning of a string by "...". </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>is the string to modify </td></tr>
<tr><td class="paramname">maxlen</td><td>is the maximum length the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00276">276</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6311e620cda65df2aeeb2344d20aa010"></a><!-- doxytag: member="KStringHandler::matchFilename" ref="a6311e620cda65df2aeeb2344d20aa010" args="(const QString &filename, const QString &pattern)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static KDE_DEPRECATED bool KStringHandler::matchFilename </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>pattern</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [inline, static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000063">Deprecated:</a></b></dt><dd>Use matchFileName () instead.</dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8h_source.html#l00435">435</a> of file <a class="el" href="kstringhandler_8h_source.html">kstringhandler.h</a>.</p>
</div>
</div>
<a class="anchor" id="a4b8d4bdb6fdb20ae82b2b527a9b0234e"></a><!-- doxytag: member="KStringHandler::matchFileName" ref="a4b8d4bdb6fdb20ae82b2b527a9b0234e" args="(const QString &filename, const QString &pattern)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStringHandler::matchFileName </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>pattern</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Match a filename. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>is the real decoded filename (or dirname without trailing '/'). </td></tr>
<tr><td class="paramname">pattern</td><td>is a pattern like *.txt, *.tar.gz, Makefile.*, *README*, etc. Patterns with two asterisks like "*.*pk" are not supported. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the given filename matches the given pattern </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00413">413</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="afa464f27b952f544619fd2059eab80b0"></a><!-- doxytag: member="KStringHandler::obscure" ref="afa464f27b952f544619fd2059eab80b0" args="(const QString &str)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::obscure </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>str</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obscure string by using a simple symmetric encryption. </p>
<p>Applying the function to a string obscured by this function will result in the original string.</p>
<p>The function can be used to obscure passwords stored to configuration files. Note that this won't give you any more security than preventing that the password is directly copied and pasted.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>string to be obscured </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>obscured string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00556">556</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a85cadf984ec2e4d3f80c17581a30e329"></a><!-- doxytag: member="KStringHandler::perlSplit" ref="a85cadf984ec2e4d3f80c17581a30e329" args="(const QString &sep, const QString &s, uint max=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStringHandler::perlSplit </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>sep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>max</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Split a <a class="elRef" href="qstring.html">QString</a> into a <a class="elRef" href="qstringlist.html">QStringList</a> in a similar fashion to the static <a class="elRef" href="qstringlist.html">QStringList</a> function in <a class="elRef" href="qt.html">Qt</a>, except you can specify a maximum number of tokens. </p>
<p>If max is specified (!= 0) then only that number of tokens will be extracted. The final token will be the remainder of the string.</p>
<p>Example: </p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classKStringHandler.html#a85cadf984ec2e4d3f80c17581a30e329" title="Split a QString into a QStringList in a similar fashion to the static QStringList function in Qt...">perlSplit</a>(<span class="stringliteral">"__"</span>, <span class="stringliteral">"some__string__for__you__here"</span>, 4)
<a class="codeRef" href="qstringlist.html">QStringList</a> contains: "some", "<span class="keywordtype">string</span>", "for", "you__here"
</pre></div><dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">sep</td><td>is the string to use to delimit s. </td></tr>
<tr><td class="paramname">s</td><td>is the input string </td></tr>
<tr><td class="paramname">max</td><td>is the maximum number of extractions to perform, or 0. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="elRef" href="qstringlist.html">QStringList</a> containing tokens extracted from s. </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00452">452</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ac616012c361a9a94d950b3b8228cbb8f"></a><!-- doxytag: member="KStringHandler::perlSplit" ref="ac616012c361a9a94d950b3b8228cbb8f" args="(const QChar &sep, const QString &s, uint max=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStringHandler::perlSplit </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qchar.html">QChar</a> & </td>
<td class="paramname"><em>sep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>max</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Split a <a class="elRef" href="qstring.html">QString</a> into a <a class="elRef" href="qstringlist.html">QStringList</a> in a similar fashion to the static <a class="elRef" href="qstringlist.html">QStringList</a> function in <a class="elRef" href="qt.html">Qt</a>, except you can specify a maximum number of tokens. </p>
<p>If max is specified (!= 0) then only that number of tokens will be extracted. The final token will be the remainder of the string.</p>
<p>Example: </p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classKStringHandler.html#a85cadf984ec2e4d3f80c17581a30e329" title="Split a QString into a QStringList in a similar fashion to the static QStringList function in Qt...">perlSplit</a>(<span class="charliteral">' '</span>, <span class="stringliteral">"kparts reaches the parts other parts can't"</span>, 3)
<a class="codeRef" href="qstringlist.html">QStringList</a> contains: "kparts", "reaches", "the parts other parts can't"
</pre></div><dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">sep</td><td>is the character to use to delimit s. </td></tr>
<tr><td class="paramname">s</td><td>is the input string </td></tr>
<tr><td class="paramname">max</td><td>is the maximum number of extractions to perform, or 0. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="elRef" href="qstringlist.html">QStringList</a> containing tokens extracted from s. </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00478">478</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a117f94c205118617b8b8b975e1b0f8c2"></a><!-- doxytag: member="KStringHandler::perlSplit" ref="a117f94c205118617b8b8b975e1b0f8c2" args="(const QRegExp &sep, const QString &s, uint max=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStringHandler::perlSplit </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qregexp.html">QRegExp</a> & </td>
<td class="paramname"><em>sep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>max</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Split a <a class="elRef" href="qstring.html">QString</a> into a <a class="elRef" href="qstringlist.html">QStringList</a> in a similar fashion to the static <a class="elRef" href="qstringlist.html">QStringList</a> function in <a class="elRef" href="qt.html">Qt</a>, except you can specify a maximum number of tokens. </p>
<p>If max is specified (!= 0) then only that number of tokens will be extracted. The final token will be the remainder of the string.</p>
<p>Example: </p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classKStringHandler.html#a85cadf984ec2e4d3f80c17581a30e329" title="Split a QString into a QStringList in a similar fashion to the static QStringList function in Qt...">perlSplit</a>(<a class="codeRef" href="qregexp.html">QRegExp</a>(<span class="stringliteral">"[! ]"</span>, <span class="stringliteral">"Split me up ! I'm bored ! OK ?"</span>, 3)
<a class="codeRef" href="qstringlist.html">QStringList</a> contains: <span class="stringliteral">"Split"</span>, <span class="stringliteral">"me"</span>, <span class="stringliteral">"up ! I'm bored, OK ?"</span>
</pre></div><dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">sep</td><td>is the regular expression to use to delimit s. </td></tr>
<tr><td class="paramname">s</td><td>is the input string </td></tr>
<tr><td class="paramname">max</td><td>is the maximum number of extractions to perform, or 0. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="elRef" href="qstringlist.html">QStringList</a> containing tokens extracted from s. </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00504">504</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a7eff79b23f4c25b8052dd4198c2608d5"></a><!-- doxytag: member="KStringHandler::remrange" ref="a7eff79b23f4c25b8052dd4198c2608d5" args="(const QString &text, const char *range)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::remrange </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>range</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes a word or ranges of words from the string, and returns a new string. </p>
<p>The ranges definitions follow the definitions for the <a class="el" href="classKStringHandler.html#a627e4dbdcb613391162bbbb91d478fbe" title="Returns the nth word in the string if found Returns a EMPTY (not null) string otherwise.">word()</a> function.</p>
<ul>
<li>"0" removes the very first word </li>
<li>"0:" removes the first the the last word </li>
<li>"0:3" removes the first to fourth words </li>
<li>":3" removes everything up to the fourth word <dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the original text </td></tr>
<tr><td class="paramname">range</td><td>the words to remove (see description) </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
</li>
</ul>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00122">122</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a3623e50903c09f16dbcd0b6ca9e3437e"></a><!-- doxytag: member="KStringHandler::rEmSqueeze" ref="a3623e50903c09f16dbcd0b6ca9e3437e" args="(const QString &name, const QFontMetrics &fontMetrics, uint maxlen=30)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::rEmSqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> & </td>
<td class="paramname"><em>fontMetrics</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxlen</em> = <code>30</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the end of a string by "...". </p>
<p>Similar to method above, except that it truncates based on pixel width rather than the number of characters </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>is the string to modify </td></tr>
<tr><td class="paramname">fontMetrics</td><td>is the font metrics to use to calculate character sizes </td></tr>
<tr><td class="paramname">maxlen</td><td>is the maximum length in ems the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00380">380</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="af969364f3569bab1beaa6e1054c07001"></a><!-- doxytag: member="KStringHandler::remword" ref="af969364f3569bab1beaa6e1054c07001" args="(const QString &text, const QString &word)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::remword </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>word</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes a matching word from the string, and returns a new string. </p>
<p>Note that only ONE match is removed. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the original text </td></tr>
<tr><td class="paramname">word</td><td>the word to remove </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00168">168</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6023d8f88fb09854c27d279c090bd72c"></a><!-- doxytag: member="KStringHandler::remword" ref="a6023d8f88fb09854c27d279c090bd72c" args="(const QString &text, uint pos)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::remword </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>pos</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes a word at the given index, and returns a new string. </p>
<p>The first index is zero (0). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the original text </td></tr>
<tr><td class="paramname">pos</td><td>the position (in words) of thw word to delete </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00151">151</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ad9ede746249d19a868ef81ba6b032b02"></a><!-- doxytag: member="KStringHandler::reverse" ref="ad9ede746249d19a868ef81ba6b032b02" args="(const QString &text)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::reverse </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reverses the order of the words in a string "hello there" becomes "there hello" (string) </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the text to reverse </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00219">219</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a9bf062c35878a3e92d14335368f96140"></a><!-- doxytag: member="KStringHandler::reverse" ref="a9bf062c35878a3e92d14335368f96140" args="(const QStringList &list)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStringHandler::reverse </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>list</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reverses the order of the words in a list [hello, there] becomes [there, hello] (list) </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">list</td><td>the list to reverse </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting list </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00233">233</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a1b7826f8f5537993b93dfe4711a73338"></a><!-- doxytag: member="KStringHandler::rjust" ref="a1b7826f8f5537993b93dfe4711a73338" args="(const QString &text, uint width) KDE_DEPRECATED" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::rjust </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>width</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Right-justifies a string and returns a string at least 'width' characters wide. </p>
<p>If the string is longer than the <code>width</code>, the original string is returned. It is never truncated. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the text to justify </td></tr>
<tr><td class="paramname">width</td><td>the desired width of the new string </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000062">Deprecated:</a></b></dt><dd>use <a class="elRef" href="qstring.html#rightJustify">QString::rightJustify</a> instead </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00256">256</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a144f69f4e94df326c7bf90c2defb3fa3"></a><!-- doxytag: member="KStringHandler::rPixelSqueeze" ref="a144f69f4e94df326c7bf90c2defb3fa3" args="(const QString &name, const QFontMetrics &fontMetrics, uint maxPixels)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::rPixelSqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qfontmetrics.html">QFontMetrics</a> & </td>
<td class="paramname"><em>fontMetrics</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxPixels</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the end of a string by "...". </p>
<p>Similar to method above, except that maxlen is the width in pixels to truncate to </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>is the string to modify </td></tr>
<tr><td class="paramname">fontMetrics</td><td>is the font metrics to use to calculate character sizes </td></tr>
<tr><td class="paramname">maxPixels</td><td>is the maximum pixel length the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00385">385</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aa1e2df6c9fb0aaf9cc6b698035bfc6ac"></a><!-- doxytag: member="KStringHandler::rsqueeze" ref="aa1e2df6c9fb0aaf9cc6b698035bfc6ac" args="(const QString &str, uint maxlen=40)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::rsqueeze </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>maxlen</em> = <code>40</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Substitute characters at the end of a string by "...". </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>is the string to modify </td></tr>
<tr><td class="paramname">maxlen</td><td>is the maximum length the modified string will have If the original string is shorter than "maxlen", it is returned verbatim </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the modified string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00294">294</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a748663a8c291be9c7c7e90430ec99865"></a><!-- doxytag: member="KStringHandler::setword" ref="a748663a8c291be9c7c7e90430ec99865" args="(const QString &text, const QString &word, uint pos)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::setword </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>word</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>pos</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Replaces a word in the string, and returns a new string with the word included. </p>
<p>the first index is zero (0). If there are not <code>pos</code> words in the original string, the new word will be appended to the end. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the original text </td></tr>
<tr><td class="paramname">word</td><td>the word to insert </td></tr>
<tr><td class="paramname">pos</td><td>the position (in words) for the new word </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting string </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00100">100</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="affded06be9938cacf7431ca9bd4f8d35"></a><!-- doxytag: member="KStringHandler::tagURLs" ref="affded06be9938cacf7431ca9bd4f8d35" args="(const QString &text)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::tagURLs </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This method auto-detects URLs in strings, and adds HTML markup to them so that richtext or HTML-enabled widgets (such as <a class="elRef" doxygen="kdeui.tag:../../kdeui/html/" href="../../kdeui/html/classKActiveLabel.html">KActiveLabel</a>) will display the URL correctly. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the string which may contain URLs </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the resulting text </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00531">531</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a627e4dbdcb613391162bbbb91d478fbe"></a><!-- doxytag: member="KStringHandler::word" ref="a627e4dbdcb613391162bbbb91d478fbe" args="(const QString &text, uint pos) KDE_DEPRECATED" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::word </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>pos</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the nth word in the string if found Returns a EMPTY (not null) string otherwise. </p>
<p>Note that the FIRST index is 0. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the string to search for the words </td></tr>
<tr><td class="paramname">pos</td><td>the position of the word to search </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the word, or an empty string if not found </dd></dl>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000060">Deprecated:</a></b></dt><dd>use <a class="elRef" href="qstring.html#section">QString::section</a> instead </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00039">39</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a98cf14bc638e296c10af75bc71b6174e"></a><!-- doxytag: member="KStringHandler::word" ref="a98cf14bc638e296c10af75bc71b6174e" args="(const QString &text, const char *range)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStringHandler::word </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>range</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a range of words from that string. </p>
<p>Ie: </p>
<ul>
<li>"0" returns the very first word </li>
<li>"0:" returns the first to the last word </li>
<li>"0:3" returns the first to fourth words </li>
<li>":3" returns everything up to the fourth word</li>
</ul>
<p>If you grok python, you're set. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">text</td><td>the string to search for the words </td></tr>
<tr><td class="paramname">range</td><td>the words to return (see description) </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the words, or an empty string if not found </dd></dl>
<p>Definition at line <a class="el" href="kstringhandler_8cpp_source.html#l00044">44</a> of file <a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kstringhandler_8h_source.html">kstringhandler.h</a></li>
<li><a class="el" href="kstringhandler_8cpp_source.html">kstringhandler.cpp</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kdecore</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="modules.html">Modules</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classKAboutData.html">kaboutdata</option>, <option value="classKAboutPerson.html">kaboutperson</option>, <option value="classKAboutTranslator.html">kabouttranslator</option>, <option value="classKAccel.html">kaccel</option>, <option value="classKAcceleratorManager.html">kacceleratormanager</option>, <option value="classKAccelManagerAlgorithm.html">kaccelmanageralgorithm</option>, <option value="classKAccelShortcutList.html">kaccelshortcutlist</option>, <option value="classKAccelString.html">kaccelstring</option>, <option value="classKAddressInfo.html">kaddressinfo</option>, <option value="classKAppDCOPInterface.html">kappdcopinterface</option>, <option value="classKApplication.html">kapplication</option>, <option value="classKAsyncIO.html">kasyncio</option>, <option value="classKAudioPlayer.html">kaudioplayer</option>, <option value="classKBufferedIO.html">kbufferedio</option>, <option value="classKCalendarSystem.html">kcalendarsystem</option>, <option value="classKCalendarSystemFactory.html">kcalendarsystemfactory</option>, <option value="classKCalendarSystemJalali.html">kcalendarsystemjalali</option>, <option value="classKCatalogue.html">kcatalogue</option>, <option value="classKCharMacroExpander.html">kcharmacroexpander</option>, <option value="classKCharsets.html">kcharsets</option>, <option value="classKClipboardSynchronizer.html">kclipboardsynchronizer</option>, <option value="classKCmdLineArgs.html">kcmdlineargs</option>, <option value="classKCodecs.html">kcodecs</option>, <option value="classKCompletion.html">kcompletion</option>, <option value="classKCompletionBase.html">kcompletionbase</option>, <option value="classKCompletionMatches.html">kcompletionmatches</option>, <option value="classKCompTreeNode.html">kcomptreenode</option>, <option value="classKConfig.html">kconfig</option>, <option value="classKConfigBackEnd.html">kconfigbackend</option>, <option value="classKConfigBase.html">kconfigbase</option>, <option value="classKConfigDialogManager.html">kconfigdialogmanager</option>, <option value="classKConfigGroup.html">kconfiggroup</option>, <option value="classKConfigGroupSaver.html">kconfiggroupsaver</option>, <option value="classKConfigINIBackEnd.html">kconfiginibackend</option>, <option value="classKConfigSkeleton.html">kconfigskeleton</option>, <option value="classKConfigSkeleton_1_1ItemBool.html">kconfigskeleton::itembool</option>, <option value="classKConfigSkeleton_1_1ItemColor.html">kconfigskeleton::itemcolor</option>, <option value="classKConfigSkeleton_1_1ItemDateTime.html">kconfigskeleton::itemdatetime</option>, <option value="classKConfigSkeleton_1_1ItemDouble.html">kconfigskeleton::itemdouble</option>, <option value="classKConfigSkeleton_1_1ItemEnum.html">kconfigskeleton::itemenum</option>, <option value="classKConfigSkeleton_1_1ItemFont.html">kconfigskeleton::itemfont</option>, <option value="classKConfigSkeleton_1_1ItemInt.html">kconfigskeleton::itemint</option>, <option value="classKConfigSkeleton_1_1ItemInt64.html">kconfigskeleton::itemint64</option>, <option value="classKConfigSkeleton_1_1ItemIntList.html">kconfigskeleton::itemintlist</option>, <option value="classKConfigSkeleton_1_1ItemLong.html">kconfigskeleton::itemlong</option>, <option value="classKConfigSkeleton_1_1ItemPassword.html">kconfigskeleton::itempassword</option>, <option value="classKConfigSkeleton_1_1ItemPath.html">kconfigskeleton::itempath</option>, <option value="classKConfigSkeleton_1_1ItemPathList.html">kconfigskeleton::itempathlist</option>, <option value="classKConfigSkeleton_1_1ItemPoint.html">kconfigskeleton::itempoint</option>, <option value="classKConfigSkeleton_1_1ItemProperty.html">kconfigskeleton::itemproperty</option>, <option value="classKConfigSkeleton_1_1ItemRect.html">kconfigskeleton::itemrect</option>, <option value="classKConfigSkeleton_1_1ItemSize.html">kconfigskeleton::itemsize</option>, <option value="classKConfigSkeleton_1_1ItemString.html">kconfigskeleton::itemstring</option>, <option value="classKConfigSkeleton_1_1ItemStringList.html">kconfigskeleton::itemstringlist</option>, <option value="classKConfigSkeleton_1_1ItemUInt.html">kconfigskeleton::itemuint</option>, <option value="classKConfigSkeleton_1_1ItemUInt64.html">kconfigskeleton::itemuint64</option>, <option value="classKConfigSkeleton_1_1ItemULong.html">kconfigskeleton::itemulong</option>, <option value="classKConfigSkeletonItem.html">kconfigskeletonitem</option>, <option value="classKCrash.html">kcrash</option>, <option value="classKDCOPPropertyProxy.html">kdcoppropertyproxy</option>, <option value="classKDebugDCOPIface.html">kdebugdcopiface</option>, <option value="classKDesktopFile.html">kdesktopfile</option>, <option value="classKExtendedSocket.html">kextendedsocket</option>, <option value="classKGenericFactory.html">kgenericfactory</option>, <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Pare1ed8d1e5a9847c99711cad3b12c7e96c.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< pare1ed8d1e5a9847c99711cad3b12c7e96c</option>, <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Paref6a00f76851e0daa2cb662bb8a41fc7f.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< paref6a00f76851e0daa2cb662bb8a41fc7f</option>, <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01QObject_01_4.html">kgenericfactory< ktypelist< product, productlisttail >, qobject ></option>, <option value="classKGlobal.html">kglobal</option>, <option value="classKGlobalAccel.html">kglobalaccel</option>, <option value="classKGlobalSettings.html">kglobalsettings</option>, <option value="classKIcon.html">kicon</option>, <option value="classKIconEffect.html">kiconeffect</option>, <option value="classKIconLoader.html">kiconloader</option>, <option value="classKIconTheme.html">kicontheme</option>, <option value="classKInetSocketAddress.html">kinetsocketaddress</option>, <option value="classKInstance.html">kinstance</option>, <option value="classKIOBufferBase.html">kiobufferbase</option>, <option value="classKIPC.html">kipc</option>, <option value="classKKey.html">kkey</option>, <option value="classKKeyNative.html">kkeynative</option>, <option value="classKKeySequence.html">kkeysequence</option>, <option value="classKLibFactory.html">klibfactory</option>, <option value="classKLibLoader.html">klibloader</option>, <option value="classKLibrary.html">klibrary</option>, <option value="classKLocale.html">klocale</option>, <option value="classKLockFile.html">klockfile</option>, <option value="classKMacroExpanderBase.html">kmacroexpanderbase</option>, <option value="classKMD4.html">kmd4</option>, <option value="classKMD5.html">kmd5</option>, <option value="classKMimeSourceFactory.html">kmimesourcefactory</option>, <option value="classKMountPoint.html">kmountpoint</option>, <option value="classKMultipleDrag.html">kmultipledrag</option>, <option value="classKNetwork_1_1KActiveSocketBase.html">knetwork::kactivesocketbase</option>, <option value="classKNetwork_1_1KBufferedSocket.html">knetwork::kbufferedsocket</option>, <option value="classKNetwork_1_1KClientSocketBase.html">knetwork::kclientsocketbase</option>, <option value="classKNetwork_1_1KDatagramPacket.html">knetwork::kdatagrampacket</option>, <option value="classKNetwork_1_1KDatagramSocket.html">knetwork::kdatagramsocket</option>, <option value="classKNetwork_1_1KHttpProxySocketDevice.html">knetwork::khttpproxysocketdevice</option>, <option value="classKNetwork_1_1KInetSocketAddress.html">knetwork::kinetsocketaddress</option>, <option value="classKNetwork_1_1KIpAddress.html">knetwork::kipaddress</option>, <option value="classKNetwork_1_1KMulticastSocket.html">knetwork::kmulticastsocket</option>, <option value="classKNetwork_1_1KMulticastSocketImpl.html">knetwork::kmulticastsocketimpl</option>, <option value="classKNetwork_1_1KNetworkInterface.html">knetwork::knetworkinterface</option>, <option value="classKNetwork_1_1KPassiveSocketBase.html">knetwork::kpassivesocketbase</option>, <option value="classKNetwork_1_1KResolver.html">knetwork::kresolver</option>, <option value="classKNetwork_1_1KResolverEntry.html">knetwork::kresolverentry</option>, <option value="classKNetwork_1_1KResolverResults.html">knetwork::kresolverresults</option>, <option value="classKNetwork_1_1KResolverWorkerBase_1_1ResolverLocker.html">knetwork::kresolverworkerbase::resolverlocker</option>, <option value="classKNetwork_1_1KReverseResolver.html">knetwork::kreverseresolver</option>, <option value="classKNetwork_1_1KServerSocket.html">knetwork::kserversocket</option>, <option value="classKNetwork_1_1KSocketAddress.html">knetwork::ksocketaddress</option>, <option value="classKNetwork_1_1KSocketBase.html">knetwork::ksocketbase</option>, <option value="classKNetwork_1_1KSocketDevice.html">knetwork::ksocketdevice</option>, <option value="classKNetwork_1_1KSocketDeviceFactory.html">knetwork::ksocketdevicefactory</option>, <option value="classKNetwork_1_1KSocksSocketDevice.html">knetwork::ksockssocketdevice</option>, <option value="classKNetwork_1_1KStreamSocket.html">knetwork::kstreamsocket</option>, <option value="classKNetwork_1_1KUnixSocketAddress.html">knetwork::kunixsocketaddress</option>, <option value="classKNotifyClient_1_1Instance.html">knotifyclient::instance</option>, <option value="classKPalette.html">kpalette</option>, <option value="classKPixmapProvider.html">kpixmapprovider</option>, <option value="classKPopupAccelManager.html">kpopupaccelmanager</option>, <option value="classKProcess.html">kprocess</option>, <option value="classKProcessController.html">kprocesscontroller</option>, <option value="classKProcIO.html">kprocio</option>, <option value="classKProtocolInfoFactory.html">kprotocolinfofactory</option>, <option value="classKPty.html">kpty</option>, <option value="classKRandomSequence.html">krandomsequence</option>, <option value="classKRegExp.html">kregexp</option>, <option value="classKRegExpPrivate.html">kregexpprivate</option>, <option value="classKRFCDate.html">krfcdate</option>, <option value="classKRootProp.html">krootprop</option>, <option value="classKSaveFile.html">ksavefile</option>, <option value="classKServerSocket.html">kserversocket</option>, <option value="classKSessionManaged.html">ksessionmanaged</option>, <option value="classKShared.html">kshared</option>, <option value="classKSharedConfig.html">ksharedconfig</option>, <option value="classKSharedPtr.html">ksharedptr</option>, <option value="classKShellProcess.html">kshellprocess</option>, <option value="classKShortcut.html">kshortcut</option>, <option value="classKShortcutList.html">kshortcutlist</option>, <option value="classKSimpleConfig.html">ksimpleconfig</option>, <option value="classKSocket.html">ksocket</option>, <option value="classKSocketAddress.html">ksocketaddress</option>, <option value="classKSocks.html">ksocks</option>, <option value="classKSortableItem.html">ksortableitem</option>, <option value="classKSortableValueList.html">ksortablevaluelist</option>, <option value="classKStandardDirs.html">kstandarddirs</option>, <option value="classKStaticDeleter.html">kstaticdeleter</option>, <option value="classKStaticDeleterBase.html">kstaticdeleterbase</option>, <option value="classKStdAccel_1_1ShortcutList.html">kstdaccel::shortcutlist</option>, <option value="classKStringHandler.html">kstringhandler</option>, <option value="classKSycocaEntry.html">ksycocaentry</option>, <option value="classKSycocaFactoryList.html">ksycocafactorylist</option>, <option value="classKTempDir.html">ktempdir</option>, <option value="classKTempFile.html">ktempfile</option>, <option value="classKTimezone.html">ktimezone</option>, <option value="classKTimezoneDetails.html">ktimezonedetails</option>, <option value="classKTimezones.html">ktimezones</option>, <option value="classKTimezoneSource.html">ktimezonesource</option>, <option value="classKUniqueApplication.html">kuniqueapplication</option>, <option value="classKUnixSocketAddress.html">kunixsocketaddress</option>, <option value="classKURL.html">kurl</option>, <option value="classKURL_1_1List.html">kurl::list</option>, <option value="classKURLDrag.html">kurldrag</option>, <option value="classKUser.html">kuser</option>, <option value="classKUserGroup.html">kusergroup</option>, <option value="classKVMAllocator.html">kvmallocator</option>, <option value="classKWin.html">kwin</option>, <option value="classKWin_1_1WindowInfo.html">kwin::windowinfo</option>, <option value="classKWinModule.html">kwinmodule</option>, <option value="classKWordMacroExpander.html">kwordmacroexpander</option>, <option value="classKXErrorHandler.html">kxerrorhandler</option>, <option value="classKZoneAllocator.html">kzoneallocator</option>, <option value="classNET.html">net</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
