\section{KIO Namespace Reference}
\label{namespaceKIO}\index{KIO@{KIO}}
A namespace for KIO globals.  


\subsection*{Classes}
\begin{CompactItemize}
\item 
class {\bf Auth\-Info}
\begin{CompactList}\small\item\em This class is intended to make it easier to prompt for, cache and retrieve authorization information. A two way messaging class for passing authentication information. \item\end{CompactList}\item 
class {\bf Net\-RC}
\begin{CompactList}\small\item\em A Singleton class that provides access to passwords stored in .netrc files for automatic login purposes. An interface to the ftp .netrc files. \item\end{CompactList}\item 
class {\bf Chmod\-Job}
\begin{CompactList}\small\item\em This job changes permissions on a list of files or directories, optionally in a recursive manner. \item\end{CompactList}\item 
class {\bf Connection}
\begin{CompactList}\small\item\em This class provides a simple means for IPC between two applications via a pipe. \item\end{CompactList}\item 
class {\bf Data\-Protocol}
\begin{CompactList}\small\item\em This kioslave provides support of data urls as specified by rfc 2397. \item\end{CompactList}\item 
class {\bf Data\-Slave}
\begin{CompactList}\small\item\em This class provides a high performance implementation for the data url scheme (rfc2397). \item\end{CompactList}\item 
class {\bf Dav\-Job}
\begin{CompactList}\small\item\em The transfer job pumps data into and/or out of a Slave. \item\end{CompactList}\item 
class {\bf Forwarding\-Slave\-Base}
\begin{CompactList}\small\item\em This class should be used as a base for ioslaves acting as a forwarder to other ioslaves. \item\end{CompactList}\item 
class {\bf Meta\-Data}
\begin{CompactList}\small\item\em {\bf Meta\-Data}{\rm (p.\,\pageref{classKIO_1_1MetaData})} is a simple map of key/value strings. \item\end{CompactList}\item 
class {\bf Job}
\begin{CompactList}\small\item\em The base class for all jobs. \item\end{CompactList}\item 
class {\bf Simple\-Job}
\begin{CompactList}\small\item\em A simple job (one url and one command). \item\end{CompactList}\item 
class {\bf Stat\-Job}
\begin{CompactList}\small\item\em A {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} job that retrieves information about a file or directory. \item\end{CompactList}\item 
class {\bf Mkdir\-Job}
\begin{CompactList}\small\item\em A {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} job that creates a directory. \item\end{CompactList}\item 
class {\bf Transfer\-Job}
\begin{CompactList}\small\item\em The transfer job pumps data into and/or out of a Slave. \item\end{CompactList}\item 
class {\bf Stored\-Transfer\-Job}
\begin{CompactList}\small\item\em {\bf Stored\-Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1StoredTransferJob})} is a {\bf Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1TransferJob})} (for downloading or uploading data) that also stores a {\bf QByte\-Array} with the data, making it simpler to use than the standard {\bf Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1TransferJob})}. \item\end{CompactList}\item 
class {\bf Multi\-Get\-Job}
\begin{CompactList}\small\item\em The {\bf Multi\-Get\-Job}{\rm (p.\,\pageref{classKIO_1_1MultiGetJob})} is a {\bf Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1TransferJob})} that allows you to get several files from a single server. \item\end{CompactList}\item 
class {\bf Mimetype\-Job}
\begin{CompactList}\small\item\em A {\bf Mimetype\-Job}{\rm (p.\,\pageref{classKIO_1_1MimetypeJob})} is a {\bf Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1TransferJob})} that allows you to get the mime type of an URL. \item\end{CompactList}\item 
class {\bf File\-Copy\-Job}
\begin{CompactList}\small\item\em The {\bf File\-Copy\-Job}{\rm (p.\,\pageref{classKIO_1_1FileCopyJob})} copies data from one place to another. \item\end{CompactList}\item 
class {\bf List\-Job}
\begin{CompactList}\small\item\em A {\bf List\-Job}{\rm (p.\,\pageref{classKIO_1_1ListJob})} is allows you to get the get the content of a directory. \item\end{CompactList}\item 
class {\bf Copy\-Job}
\begin{CompactList}\small\item\em {\bf Copy\-Job}{\rm (p.\,\pageref{classKIO_1_1CopyJob})} is used to move, copy or symlink files and directories. \item\end{CompactList}\item 
class {\bf Delete\-Job}
\begin{CompactList}\small\item\em A more complex {\bf Job}{\rm (p.\,\pageref{classKIO_1_1Job})} to delete files and directories. \item\end{CompactList}\item 
class {\bf Meta\-Info\-Job}
\begin{CompactList}\small\item\em {\bf Meta\-Info\-Job}{\rm (p.\,\pageref{classKIO_1_1MetaInfoJob})} is a {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} {\bf Job}{\rm (p.\,\pageref{classKIO_1_1Job})} to retrieve meta information from files. {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} {\bf Job}{\rm (p.\,\pageref{classKIO_1_1Job})} to retrieve meta information from files. \begin{Desc}
\item[Since:]3.1. \end{Desc}
\item\end{CompactList}\item 
class {\bf Net\-Access}
\begin{CompactList}\small\item\em Net Transparency. Provides an easy, synchronous interface to {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} file operations. \item\end{CompactList}\item 
class {\bf Password\-Dialog}
\begin{CompactList}\small\item\em A dialog for requesting a login and a password from the end user. dialog for requesting login and password from the end user. \item\end{CompactList}\item 
class {\bf Preview\-Job}
\begin{CompactList}\small\item\em {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} {\bf Job}{\rm (p.\,\pageref{classKIO_1_1Job})} to get a thumbnail picture. \item\end{CompactList}\item 
class {\bf Progress\-Base}
\begin{CompactList}\small\item\em This class does all initialization stuff for progress, like connecting signals to slots. Base class for IO progress dialogs. \item\end{CompactList}\item 
class {\bf Rename\-Dlg}
\begin{CompactList}\small\item\em A dialog for the options to rename two files. A dialog for renaming files. \begin{Desc}
\item[Since:]3.1. \end{Desc}
\item\end{CompactList}\item 
class {\bf Scheduler}
\begin{CompactList}\small\item\em The KIO::Scheduler manages io-slaves for the application. \item\end{CompactList}\item 
class {\bf Slave\-Base}
\begin{CompactList}\small\item\em There are two classes that specifies the protocol between application (job) and kioslave. \item\end{CompactList}\item 
class {\bf Slave\-Config}
\begin{CompactList}\small\item\em {\bf Slave\-Config}{\rm (p.\,\pageref{classKIO_1_1SlaveConfig})}. \item\end{CompactList}\item 
class {\bf Slave\-Interface}
\begin{CompactList}\small\item\em There are two classes that specifies the protocol between application ( {\bf KIO::Job}{\rm (p.\,\pageref{classKIO_1_1Job})}) and kioslave. \item\end{CompactList}\item 
class {\bf Statusbar\-Progress}
\begin{CompactList}\small\item\em This is a special IO progress widget. IO progress widget for embedding in a statusbar. \item\end{CompactList}\item 
class {\bf TCPSlave\-Base}
\begin{CompactList}\small\item\em There are two classes that specifies the protocol between application (job) and kioslave. \item\end{CompactList}\end{CompactItemize}
\subsection*{Typedefs}
\begin{CompactItemize}
\item 
typedef Q\_\-LLONG {\bf fileoffset\_\-t}
\item 
typedef Q\_\-ULLONG {\bf filesize\_\-t}
\item 
typedef {\bf QValue\-List}$<$ UDSAtom $>$ {\bf UDSEntry}
\item 
typedef {\bf QValue\-List}$<$ {\bf UDSEntry} $>$ {\bf UDSEntry\-List}\label{namespaceKIO_a3}

\item 
typedef {\bf QValue\-List\-Iterator}$<$ {\bf UDSEntry} $>$ {\bf UDSEntry\-List\-Iterator}\label{namespaceKIO_a4}

\item 
typedef {\bf QValue\-List\-Const\-Iterator}$<$ {\bf UDSEntry} $>$ {\bf UDSEntry\-List\-Const\-Iterator}\label{namespaceKIO_a5}

\end{CompactItemize}
\subsection*{Enumerations}
\begin{CompactItemize}
\item 
enum {\bf Command} \{ \par
{\bf CMD\_\-HOST} =  '0', 
{\bf CMD\_\-CONNECT} =  '1', 
{\bf CMD\_\-DISCONNECT} =  '2', 
{\bf CMD\_\-SLAVE\_\-STATUS} =  '3', 
\par
{\bf CMD\_\-SLAVE\_\-CONNECT} =  '4', 
{\bf CMD\_\-SLAVE\_\-HOLD} =  '5', 
{\bf CMD\_\-NONE} =  'A', 
{\bf CMD\_\-TESTDIR} =  'B', 
\par
{\bf CMD\_\-GET} =  'C', 
{\bf CMD\_\-PUT} =  'D', 
{\bf CMD\_\-STAT} =  'E', 
{\bf CMD\_\-MIMETYPE} =  'F', 
\par
{\bf CMD\_\-LISTDIR} =  'G', 
{\bf CMD\_\-MKDIR} =  'H', 
{\bf CMD\_\-RENAME} =  'I', 
{\bf CMD\_\-COPY} =  'J', 
\par
{\bf CMD\_\-DEL} =  'K', 
{\bf CMD\_\-CHMOD} =  'L', 
{\bf CMD\_\-SPECIAL} =  'M', 
{\bf CMD\_\-USERPASS} =  'N', 
\par
{\bf CMD\_\-REPARSECONFIGURATION} =  'O', 
{\bf CMD\_\-META\_\-DATA} =  'P', 
{\bf CMD\_\-SYMLINK} =  'Q', 
{\bf CMD\_\-SUBURL} =  'R', 
\par
{\bf CMD\_\-MESSAGEBOXANSWER} =  'S', 
{\bf CMD\_\-RESUMEANSWER} =  'T', 
{\bf CMD\_\-CONFIG} =  'U', 
{\bf CMD\_\-MULTI\_\-GET} =  'V'
 \}
\item 
enum {\bf Error} \{ \par
{\bf ERR\_\-CANNOT\_\-OPEN\_\-FOR\_\-READING} =  1, 
{\bf ERR\_\-CANNOT\_\-OPEN\_\-FOR\_\-WRITING} =  2, 
{\bf ERR\_\-CANNOT\_\-LAUNCH\_\-PROCESS} =  3, 
{\bf ERR\_\-INTERNAL} =  4, 
\par
{\bf ERR\_\-MALFORMED\_\-URL} =  5, 
{\bf ERR\_\-UNSUPPORTED\_\-PROTOCOL} =  6, 
{\bf ERR\_\-NO\_\-SOURCE\_\-PROTOCOL} =  7, 
{\bf ERR\_\-UNSUPPORTED\_\-ACTION} =  8, 
\par
{\bf ERR\_\-IS\_\-DIRECTORY} =  9, 
{\bf ERR\_\-IS\_\-FILE} =  10, 
{\bf ERR\_\-DOES\_\-NOT\_\-EXIST} =  11, 
{\bf ERR\_\-FILE\_\-ALREADY\_\-EXIST} =  12, 
\par
{\bf ERR\_\-DIR\_\-ALREADY\_\-EXIST} =  13, 
{\bf ERR\_\-UNKNOWN\_\-HOST} =  14, 
{\bf ERR\_\-ACCESS\_\-DENIED} =  15, 
{\bf ERR\_\-WRITE\_\-ACCESS\_\-DENIED} =  16, 
\par
{\bf ERR\_\-CANNOT\_\-ENTER\_\-DIRECTORY} =  17, 
{\bf ERR\_\-PROTOCOL\_\-IS\_\-NOT\_\-A\_\-FILESYSTEM} =  18, 
{\bf ERR\_\-CYCLIC\_\-LINK} =  19, 
{\bf ERR\_\-USER\_\-CANCELED} =  20, 
\par
{\bf ERR\_\-CYCLIC\_\-COPY} =  21, 
{\bf ERR\_\-COULD\_\-NOT\_\-CREATE\_\-SOCKET} =  22, 
{\bf ERR\_\-COULD\_\-NOT\_\-CONNECT} =  23, 
{\bf ERR\_\-CONNECTION\_\-BROKEN} =  24, 
\par
{\bf ERR\_\-NOT\_\-FILTER\_\-PROTOCOL} =  25, 
{\bf ERR\_\-COULD\_\-NOT\_\-MOUNT} =  26, 
{\bf ERR\_\-COULD\_\-NOT\_\-UNMOUNT} =  27, 
{\bf ERR\_\-COULD\_\-NOT\_\-READ} =  28, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-WRITE} =  29, 
{\bf ERR\_\-COULD\_\-NOT\_\-BIND} =  30, 
{\bf ERR\_\-COULD\_\-NOT\_\-LISTEN} =  31, 
{\bf ERR\_\-COULD\_\-NOT\_\-ACCEPT} =  32, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-LOGIN} =  33, 
{\bf ERR\_\-COULD\_\-NOT\_\-STAT} =  34, 
{\bf ERR\_\-COULD\_\-NOT\_\-CLOSEDIR} =  35, 
{\bf ERR\_\-COULD\_\-NOT\_\-MKDIR} =  37, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-RMDIR} =  38, 
{\bf ERR\_\-CANNOT\_\-RESUME} =  39, 
{\bf ERR\_\-CANNOT\_\-RENAME} =  40, 
{\bf ERR\_\-CANNOT\_\-CHMOD} =  41, 
\par
{\bf ERR\_\-CANNOT\_\-DELETE} =  42, 
{\bf ERR\_\-SLAVE\_\-DIED} =  43, 
{\bf ERR\_\-OUT\_\-OF\_\-MEMORY} =  44, 
{\bf ERR\_\-UNKNOWN\_\-PROXY\_\-HOST} =  45, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-AUTHENTICATE} =  46, 
{\bf ERR\_\-ABORTED} =  47, 
{\bf ERR\_\-INTERNAL\_\-SERVER} =  48, 
{\bf ERR\_\-SERVER\_\-TIMEOUT} =  49, 
\par
{\bf ERR\_\-SERVICE\_\-NOT\_\-AVAILABLE} =  50, 
{\bf ERR\_\-UNKNOWN} =  51, 
{\bf ERR\_\-UNKNOWN\_\-INTERRUPT} =  53, 
{\bf ERR\_\-CANNOT\_\-DELETE\_\-ORIGINAL} =  54, 
\par
{\bf ERR\_\-CANNOT\_\-DELETE\_\-PARTIAL} =  55, 
{\bf ERR\_\-CANNOT\_\-RENAME\_\-ORIGINAL} =  56, 
{\bf ERR\_\-CANNOT\_\-RENAME\_\-PARTIAL} =  57, 
{\bf ERR\_\-NEED\_\-PASSWD} =  58, 
\par
{\bf ERR\_\-CANNOT\_\-SYMLINK} =  59, 
{\bf ERR\_\-NO\_\-CONTENT} =  60, 
{\bf ERR\_\-DISK\_\-FULL} =  61, 
{\bf ERR\_\-IDENTICAL\_\-FILES} =  62, 
\par
{\bf ERR\_\-SLAVE\_\-DEFINED} =  63, 
{\bf ERR\_\-UPGRADE\_\-REQUIRED} =  64, 
{\bf ERR\_\-POST\_\-DENIED} =  65
 \}
\item 
enum {\bf UDSAtom\-Types} \{ \par
{\bf UDS\_\-STRING} =  1, 
{\bf UDS\_\-LONG} =  2, 
{\bf UDS\_\-TIME} =  4 $|$ UDS\_\-LONG, 
{\bf UDS\_\-SIZE} =  8 $|$ UDS\_\-LONG, 
\par
{\bf UDS\_\-SIZE\_\-LARGE} =  32768 $|$ UDS\_\-LONG, 
{\bf UDS\_\-USER} =  16 $|$ UDS\_\-STRING, 
{\bf UDS\_\-ICON\_\-NAME} =  24 $|$ UDS\_\-STRING, 
{\bf UDS\_\-GROUP} =  32 $|$ UDS\_\-STRING, 
\par
{\bf UDS\_\-EXTRA} =  48 $|$ UDS\_\-STRING, 
{\bf UDS\_\-NAME} =  64 $|$ UDS\_\-STRING, 
{\bf UDS\_\-LOCAL\_\-PATH} =  72 $|$ UDS\_\-STRING, 
{\bf UDS\_\-ACCESS} =  128 $|$ UDS\_\-LONG, 
\par
{\bf UDS\_\-MODIFICATION\_\-TIME} =  256 $|$ UDS\_\-TIME, 
{\bf UDS\_\-ACCESS\_\-TIME} =  512 $|$ UDS\_\-TIME, 
{\bf UDS\_\-CREATION\_\-TIME} =  1024 $|$ UDS\_\-TIME, 
{\bf UDS\_\-FILE\_\-TYPE} =  2048 $|$ UDS\_\-LONG, 
\par
{\bf UDS\_\-LINK\_\-DEST} =  4096 $|$ UDS\_\-STRING, 
{\bf UDS\_\-URL} =  8192 $|$ UDS\_\-STRING, 
{\bf UDS\_\-MIME\_\-TYPE} =  16384 $|$ UDS\_\-STRING, 
{\bf UDS\_\-GUESSED\_\-MIME\_\-TYPE} =  16392 $|$ UDS\_\-STRING, 
\par
{\bf UDS\_\-XML\_\-PROPERTIES} =  32768 $|$ UDS\_\-STRING
 \}
\item 
enum {\bf Cache\-Control} \{ \par
{\bf CC\_\-Cache\-Only}, 
{\bf CC\_\-Cache}, 
{\bf CC\_\-Verify}, 
{\bf CC\_\-Refresh}, 
\par
{\bf CC\_\-Reload}
 \}
\item 
enum {\bf File\-System\-Flag} \{ \par
{\bf Supports\-Chmod}, 
{\bf Supports\-Chown}, 
{\bf Supports\-UTime}, 
{\bf Supports\-Symlinks}, 
\par
{\bf Case\-Insensitive}
 \}
\item 
enum {\bf Progress} \{ {\bf DEFAULT} =  1, 
{\bf STATUSBAR} =  2, 
{\bf LIST} =  3
 \}
\item 
enum {\bf Rename\-Dlg\_\-Mode} \{ \par
{\bf M\_\-OVERWRITE} =  1, 
{\bf M\_\-OVERWRITE\_\-ITSELF} =  2, 
{\bf M\_\-SKIP} =  4, 
{\bf M\_\-SINGLE} =  8, 
\par
{\bf M\_\-MULTI} =  16, 
{\bf M\_\-RESUME} =  32, 
{\bf M\_\-NORENAME} =  64
 \}
\item 
enum {\bf Rename\-Dlg\_\-Result} \{ \par
{\bf R\_\-RESUME} =  6, 
{\bf R\_\-RESUME\_\-ALL} =  7, 
{\bf R\_\-OVERWRITE} =  4, 
{\bf R\_\-OVERWRITE\_\-ALL} =  5, 
\par
{\bf R\_\-SKIP} =  2, 
{\bf R\_\-AUTO\_\-SKIP} =  3, 
{\bf R\_\-RENAME} =  1, 
{\bf R\_\-CANCEL} =  0
 \}
\item 
enum {\bf Skip\-Dlg\_\-Result} \{ {\bf S\_\-SKIP} =  1, 
{\bf S\_\-AUTO\_\-SKIP} =  2, 
{\bf S\_\-CANCEL} =  0
 \}
\item 
enum {\bf Info} \{ \par
{\bf INF\_\-TOTAL\_\-SIZE} =  10, 
{\bf INF\_\-PROCESSED\_\-SIZE} =  11, 
{\bf INF\_\-SPEED}, 
{\bf INF\_\-REDIRECTION} =  20, 
\par
{\bf INF\_\-MIME\_\-TYPE} =  21, 
{\bf INF\_\-ERROR\_\-PAGE} =  22, 
{\bf INF\_\-WARNING} =  23, 
{\bf INF\_\-GETTING\_\-FILE}, 
\par
{\bf INF\_\-NEED\_\-PASSWD} =  25, 
{\bf INF\_\-INFOMESSAGE}, 
{\bf INF\_\-META\_\-DATA}, 
{\bf INF\_\-NETWORK\_\-STATUS}, 
\par
{\bf INF\_\-MESSAGEBOX}
 \}
\item 
enum {\bf Message} \{ \par
{\bf MSG\_\-DATA} =  100, 
{\bf MSG\_\-DATA\_\-REQ}, 
{\bf MSG\_\-ERROR}, 
{\bf MSG\_\-CONNECTED}, 
\par
{\bf MSG\_\-FINISHED}, 
{\bf MSG\_\-STAT\_\-ENTRY}, 
{\bf MSG\_\-LIST\_\-ENTRIES}, 
{\bf MSG\_\-RENAMED}, 
\par
{\bf MSG\_\-RESUME}, 
{\bf MSG\_\-SLAVE\_\-STATUS}, 
{\bf MSG\_\-SLAVE\_\-ACK}, 
{\bf MSG\_\-NET\_\-REQUEST}, 
\par
{\bf MSG\_\-NET\_\-DROP}, 
{\bf MSG\_\-NEED\_\-SUBURL\_\-DATA}, 
{\bf MSG\_\-CANRESUME}, 
{\bf MSG\_\-AUTH\_\-KEY}, 
\par
{\bf MSG\_\-DEL\_\-AUTH\_\-KEY}
 \}
\end{CompactItemize}
\subsection*{Functions}
\begin{CompactItemize}
\item 
KIO\_\-EXPORT {\bf QData\-Stream} \& {\bf operator$<$$<$} ({\bf QData\-Stream} \&s, const {\bf Auth\-Info} \&a)\label{namespaceKIO_a180}

\item 
KIO\_\-EXPORT {\bf QData\-Stream} \& {\bf operator$>$$>$} ({\bf QData\-Stream} \&s, {\bf Auth\-Info} \&a)\label{namespaceKIO_a181}

\item 
KIO\_\-EXPORT {\bf Chmod\-Job} $\ast$ {\bf chmod} (const {\bf KFile\-Item\-List} \&lst\-Items, int permissions, int mask, {\bf QString} new\-Owner, {\bf QString} new\-Group, bool recursive, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Dav\-Job} $\ast$ {\bf dav\-Prop\-Find} (const {\bf KURL} \&url, const {\bf QDom\-Document} \&properties, {\bf QString} depth, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Dav\-Job} $\ast$ {\bf dav\-Prop\-Patch} (const {\bf KURL} \&url, const {\bf QDom\-Document} \&properties, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Dav\-Job} $\ast$ {\bf dav\-Search} (const {\bf KURL} \&url, const {\bf QString} \&ns\-URI, const {\bf QString} \&q\-Name, const {\bf QString} \&query, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf QString} {\bf convert\-Size} ({\bf KIO::filesize\_\-t} size)
\item 
KIO\_\-EXPORT {\bf QString} {\bf number} ({\bf KIO::filesize\_\-t} size)
\item 
KIO\_\-EXPORT {\bf QString} {\bf convert\-Size\-From\-KB} ({\bf KIO::filesize\_\-t} kb\-Size)
\item 
KIO\_\-EXPORT unsigned int {\bf calculate\-Remaining\-Seconds} ({\bf KIO::filesize\_\-t} total\-Size, {\bf KIO::filesize\_\-t} processed\-Size, {\bf KIO::filesize\_\-t} speed)
\item 
KIO\_\-EXPORT {\bf QString} {\bf convert\-Seconds} (unsigned int seconds)
\item 
KIO\_\-EXPORT {\bf QTime} {\bf calculate\-Remaining} ({\bf KIO::filesize\_\-t} total\-Size, {\bf KIO::filesize\_\-t} processed\-Size, {\bf KIO::filesize\_\-t} speed) KDE\_\-DEPRECATED
\item 
KIO\_\-EXPORT {\bf QString} {\bf items\-Summary\-String} (uint items, uint files, uint dirs, {\bf KIO::filesize\_\-t} size, bool show\-Size)
\item 
KIO\_\-EXPORT {\bf QString} {\bf encode\-File\-Name} (const {\bf QString} \&str)
\item 
KIO\_\-EXPORT {\bf QString} {\bf decode\-File\-Name} (const {\bf QString} \&str)
\item 
KIO\_\-EXPORT {\bf QString} {\bf build\-Error\-String} (int error\-Code, const {\bf QString} \&error\-Text)
\item 
KIO\_\-EXPORT {\bf QString} {\bf build\-HTMLError\-String} (int error\-Code, const {\bf QString} \&error\-Text, const {\bf KURL} $\ast$req\-Url=0L, int method=-1)
\item 
KIO\_\-EXPORT {\bf QByte\-Array} {\bf raw\-Error\-Detail} (int error\-Code, const {\bf QString} \&error\-Text, const {\bf KURL} $\ast$req\-Url=0L, int method=-1)
\item 
KIO\_\-EXPORT {\bf QString} {\bf unsupported\-Action\-Error\-String} (const {\bf QString} \&protocol, int cmd)
\item 
KIO\_\-EXPORT {\bf KIO::Cache\-Control} {\bf parse\-Cache\-Control} (const {\bf QString} \&cache\-Control)
\item 
KIO\_\-EXPORT {\bf QString} {\bf get\-Cache\-Control\-String} ({\bf KIO::Cache\-Control} cache\-Control)
\item 
KIO\_\-EXPORT {\bf QString} {\bf find\-Device\-Mount\-Point} (const {\bf QString} \&device)
\item 
KIO\_\-EXPORT {\bf QString} {\bf find\-Path\-Mount\-Point} (const {\bf QString} \&filename)
\item 
KIO\_\-EXPORT bool {\bf probably\_\-slow\_\-mounted} (const {\bf QString} \&filename)
\item 
KIO\_\-EXPORT bool {\bf manually\_\-mounted} (const {\bf QString} \&filename)
\item 
KIO\_\-EXPORT bool {\bf test\-File\-System\-Flag} (const {\bf QString} \&filename, File\-System\-Flag flag)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf mkdir} (const {\bf KURL} \&url, int permissions=-1)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf rmdir} (const {\bf KURL} \&url)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf chmod} (const {\bf KURL} \&url, int permissions)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf rename} (const {\bf KURL} \&src, const {\bf KURL} \&dest, bool overwrite)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf symlink} (const {\bf QString} \&target, const {\bf KURL} \&dest, bool overwrite, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf special} (const {\bf KURL} \&url, const {\bf QByte\-Array} \&data, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf mount} (bool ro, const char $\ast$fstype, const {\bf QString} \&dev, const {\bf QString} \&point, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf unmount} (const {\bf QString} \&point, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf http\_\-update\_\-cache} (const {\bf KURL} \&url, bool no\_\-cache, time\_\-t expire\-Date)
\item 
KIO\_\-EXPORT {\bf Stat\-Job} $\ast$ {\bf stat} (const {\bf KURL} \&url, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Stat\-Job} $\ast$ {\bf stat} (const {\bf KURL} \&url, bool side\-Is\-Source, short int details, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Transfer\-Job} $\ast$ {\bf get} (const {\bf KURL} \&url, bool reload=false, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Transfer\-Job} $\ast$ {\bf put} (const {\bf KURL} \&url, int permissions, bool overwrite, bool resume, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Transfer\-Job} $\ast$ {\bf http\_\-post} (const {\bf KURL} \&url, const {\bf QByte\-Array} \&post\-Data, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Stored\-Transfer\-Job} $\ast$ {\bf stored\-Get} (const {\bf KURL} \&url, bool reload=false, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Stored\-Transfer\-Job} $\ast$ {\bf stored\-Put} (const {\bf QByte\-Array} \&arr, const {\bf KURL} \&url, int permissions, bool overwrite, bool resume, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Multi\-Get\-Job} $\ast$ {\bf multi\_\-get} (long id, const {\bf KURL} \&url, const {\bf Meta\-Data} \&meta\-Data)
\item 
KIO\_\-EXPORT {\bf Mimetype\-Job} $\ast$ {\bf mimetype} (const {\bf KURL} \&url, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf File\-Copy\-Job} $\ast$ {\bf file\_\-copy} (const {\bf KURL} \&src, const {\bf KURL} \&dest, int permissions=-1, bool overwrite=false, bool resume=false, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf File\-Copy\-Job} $\ast$ {\bf file\_\-move} (const {\bf KURL} \&src, const {\bf KURL} \&dest, int permissions=-1, bool overwrite=false, bool resume=false, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Simple\-Job} $\ast$ {\bf file\_\-delete} (const {\bf KURL} \&src, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf List\-Job} $\ast$ {\bf list\-Dir} (const {\bf KURL} \&url, bool show\-Progress\-Info=true, bool include\-Hidden=true)
\item 
KIO\_\-EXPORT {\bf List\-Job} $\ast$ {\bf list\-Recursive} (const {\bf KURL} \&url, bool show\-Progress\-Info=true, bool include\-Hidden=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf copy} (const {\bf KURL} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf copy\-As} (const {\bf KURL} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf copy} (const {\bf KURL::List} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf move} (const {\bf KURL} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf move\-As} (const {\bf KURL} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf move} (const {\bf KURL::List} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf link} (const {\bf KURL} \&src, const {\bf KURL} \&dest\-Dir, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf link} (const {\bf KURL::List} \&src, const {\bf KURL} \&dest\-Dir, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf link\-As} (const {\bf KURL} \&src, const {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf trash} (const {\bf KURL} \&src, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf trash} (const {\bf KURL::List} \&src, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Delete\-Job} $\ast$ {\bf del} (const {\bf KURL} \&src, bool shred=false, bool show\-Progress\-Info=true)
\item 
KIO\_\-EXPORT {\bf Delete\-Job} $\ast$ {\bf del} (const {\bf KURL::List} \&src, bool shred=false, bool show\-Progress\-Info=true)
\item 
int {\bf match\-Constraint} (const Parse\-Tree\-Base $\ast$\_\-tree, const {\bf KService::Ptr} \&\_\-service, const {\bf KService\-Type\-Profile::Offer\-List} \&\_\-list)\label{namespaceKIO_a242}

\item 
Preferences\-Return {\bf match\-Preferences} (const Parse\-Tree\-Base $\ast$\_\-tree, const {\bf KService::Ptr} \&\_\-service, const {\bf KService\-Type\-Profile::Offer\-List} \&\_\-list)\label{namespaceKIO_a243}

\item 
KIO\_\-EXPORT {\bf Parse\-Tree\-Base::Ptr} {\bf parse\-Constraints} (const {\bf QString} \&\_\-constr)\label{namespaceKIO_a244}

\item 
KIO\_\-EXPORT {\bf Parse\-Tree\-Base::Ptr} {\bf parse\-Preferences} (const {\bf QString} \&\_\-prefs)\label{namespaceKIO_a245}

\item 
KIO\_\-EXPORT {\bf Meta\-Info\-Job} $\ast$ {\bf file\-Meta\-Info} (const {\bf KFile\-Item\-List} \&items)
\item 
KIO\_\-EXPORT {\bf Meta\-Info\-Job} $\ast$ {\bf file\-Meta\-Info} (const {\bf KURL::List} \&items)
\item 
class KIO\_\-EXPORT {\bf Job} $\ast$ {\bf paste\-Clipboard} (const {\bf KURL} \&\_\-dest\_\-url, bool move=false)
\item 
KIO\_\-EXPORT void {\bf paste\-Data} (const {\bf KURL} \&\_\-dest\_\-url, const {\bf QByte\-Array} \&\_\-data)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf paste\-Data\-Async} (const {\bf KURL} \&\_\-dest\_\-url, const {\bf QByte\-Array} \&\_\-data)
\item 
KIO\_\-EXPORT {\bf Copy\-Job} $\ast$ {\bf paste\-Data\-Async} (const {\bf KURL} \&\_\-dest\_\-url, const {\bf QByte\-Array} \&\_\-data, const {\bf QString} \&text)
\item 
KIO\_\-EXPORT bool {\bf is\-Clipboard\-Empty} ()
\item 
KIO\_\-EXPORT {\bf Preview\-Job} $\ast$ {\bf file\-Preview} (const {\bf KFile\-Item\-List} \&items, int width, int height=0, int icon\-Size=0, int icon\-Alpha=70, bool scale=true, bool save=true, const {\bf QString\-List} $\ast$enabled\-Plugins=0)
\item 
KIO\_\-EXPORT {\bf Preview\-Job} $\ast$ {\bf file\-Preview} (const {\bf KURL::List} \&items, int width, int height=0, int icon\-Size=0, int icon\-Alpha=70, bool scale=true, bool save=true, const {\bf QString\-List} $\ast$enabled\-Plugins=0)
\item 
KIO\_\-EXPORT {\bf Rename\-Dlg\_\-Result} {\bf open\_\-Rename\-Dlg} (const {\bf QString} \&caption, const {\bf QString} \&src, const {\bf QString} \&dest, Rename\-Dlg\_\-Mode mode, {\bf QString} \&new\-Dest\-Path, {\bf KIO::filesize\_\-t} size\-Src=({\bf KIO::filesize\_\-t})-1, {\bf KIO::filesize\_\-t} size\-Dest=({\bf KIO::filesize\_\-t})-1, time\_\-t ctime\-Src=(time\_\-t)-1, time\_\-t ctime\-Dest=(time\_\-t)-1, time\_\-t mtime\-Src=(time\_\-t)-1, time\_\-t mtime\-Dest=(time\_\-t)-1)\label{group__renamedlg_ga0}

\item 
KIO\_\-EXPORT Skip\-Dlg\_\-Result {\bf open\_\-Skip\-Dlg} (bool \_\-multi, const {\bf QString} \&\_\-error\_\-text=QString::null)\label{namespaceKIO_a256}

\item 
static void {\bf read\-Config} ({\bf KConfig} $\ast$config, const {\bf QString} \&group, {\bf Meta\-Data} $\ast$meta\-Data)\label{namespaceKIO_a257}

\end{CompactItemize}
\subsection*{Variables}
\begin{CompactItemize}
\item 
static {\bf KStatic\-Deleter}$<$ {\bf Slave\-Config} $>$ {\bf slaveconfigsd}\label{namespaceKIO_a149}

\end{CompactItemize}


\subsection{Detailed Description}
A namespace for KIO globals. 

\subsection{Typedef Documentation}
\index{KIO@{KIO}!fileoffset_t@{fileoffset\_\-t}}
\index{fileoffset_t@{fileoffset\_\-t}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}typedef Q\_\-LLONG {\bf KIO::fileoffset\_\-t}}\label{namespaceKIO_a0}


64-bit file offset 



Definition at line 37 of file global.h.\index{KIO@{KIO}!filesize_t@{filesize\_\-t}}
\index{filesize_t@{filesize\_\-t}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}typedef Q\_\-ULLONG {\bf KIO::filesize\_\-t}}\label{namespaceKIO_a1}


64-bit file size 



Definition at line 39 of file global.h.\index{KIO@{KIO}!UDSEntry@{UDSEntry}}
\index{UDSEntry@{UDSEntry}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}typedef {\bf QValue\-List}$<$UDSAtom$>$ {\bf KIO::UDSEntry}}\label{namespaceKIO_a2}


An entry is the list of atoms containing all the informations for a file or URL. 



Definition at line 483 of file global.h.

\subsection{Enumeration Type Documentation}
\index{KIO@{KIO}!Command@{Command}}
\index{Command@{Command}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Command}}\label{namespaceKIO_a258}


Commands that can be invoked by a job. 



Definition at line 130 of file global.h.\index{KIO@{KIO}!Error@{Error}}
\index{Error@{Error}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Error}}\label{namespaceKIO_a259}


Error codes that can be emitted by KIO. 



Definition at line 166 of file global.h.\index{KIO@{KIO}!UDSAtomTypes@{UDSAtomTypes}}
\index{UDSAtomTypes@{UDSAtomTypes}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::UDSAtom\-Types}}\label{namespaceKIO_a260}


Constants used to specify the type of a KUDSAtom. 

\begin{Desc}
\item[Enumeration values: ]\par
\begin{description}
\index{UDS_STRING@{UDS\_\-STRING}!KIO@{KIO}}\index{KIO@{KIO}!UDS_STRING@{UDS\_\-STRING}}\item[{\em 
UDS\_\-STRING\label{namespaceKIO_a260a97}
}]First let's define the item types. \index{UDS_SIZE@{UDS\_\-SIZE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_SIZE@{UDS\_\-SIZE}}\item[{\em 
UDS\_\-SIZE\label{namespaceKIO_a260a100}
}]Size of the file. \index{UDS_USER@{UDS\_\-USER}!KIO@{KIO}}\index{KIO@{KIO}!UDS_USER@{UDS\_\-USER}}\item[{\em 
UDS\_\-USER\label{namespaceKIO_a260a102}
}]User ID of the file owner. \index{UDS_ICON_NAME@{UDS\_\-ICON\_\-NAME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_ICON_NAME@{UDS\_\-ICON\_\-NAME}}\item[{\em 
UDS\_\-ICON\_\-NAME\label{namespaceKIO_a260a103}
}]Name of the icon, that should be used for displaying. 

It overrides all other detection mechanisms \begin{Desc}
\item[Since:]3.2 \end{Desc}
\index{UDS_GROUP@{UDS\_\-GROUP}!KIO@{KIO}}\index{KIO@{KIO}!UDS_GROUP@{UDS\_\-GROUP}}\item[{\em 
UDS\_\-GROUP\label{namespaceKIO_a260a104}
}]Group ID of the file owner. \index{UDS_EXTRA@{UDS\_\-EXTRA}!KIO@{KIO}}\index{KIO@{KIO}!UDS_EXTRA@{UDS\_\-EXTRA}}\item[{\em 
UDS\_\-EXTRA\label{namespaceKIO_a260a105}
}]Extra data (used only if you specified Columns/Columns\-Types) This is the only UDS entry that can be repeated. 

\begin{Desc}
\item[Since:]3.2 \end{Desc}
\index{UDS_NAME@{UDS\_\-NAME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_NAME@{UDS\_\-NAME}}\item[{\em 
UDS\_\-NAME\label{namespaceKIO_a260a106}
}]Filename - as displayed in directory listings etc. 

\char`\"{}.\char`\"{} has the usual special meaning of \char`\"{}current directory\char`\"{} \index{UDS_LOCAL_PATH@{UDS\_\-LOCAL\_\-PATH}!KIO@{KIO}}\index{KIO@{KIO}!UDS_LOCAL_PATH@{UDS\_\-LOCAL\_\-PATH}}\item[{\em 
UDS\_\-LOCAL\_\-PATH\label{namespaceKIO_a260a107}
}]A local file path if the ioslave display files sitting on the local filesystem (but in another hierarchy, e.g. 

media:/) \index{UDS_ACCESS@{UDS\_\-ACCESS}!KIO@{KIO}}\index{KIO@{KIO}!UDS_ACCESS@{UDS\_\-ACCESS}}\item[{\em 
UDS\_\-ACCESS\label{namespaceKIO_a260a108}
}]Access permissions (part of the mode returned by stat). \index{UDS_MODIFICATION_TIME@{UDS\_\-MODIFICATION\_\-TIME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_MODIFICATION_TIME@{UDS\_\-MODIFICATION\_\-TIME}}\item[{\em 
UDS\_\-MODIFICATION\_\-TIME\label{namespaceKIO_a260a109}
}]The last time the file was modified. \index{UDS_ACCESS_TIME@{UDS\_\-ACCESS\_\-TIME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_ACCESS_TIME@{UDS\_\-ACCESS\_\-TIME}}\item[{\em 
UDS\_\-ACCESS\_\-TIME\label{namespaceKIO_a260a110}
}]The last time the file was opened. \index{UDS_CREATION_TIME@{UDS\_\-CREATION\_\-TIME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_CREATION_TIME@{UDS\_\-CREATION\_\-TIME}}\item[{\em 
UDS\_\-CREATION\_\-TIME\label{namespaceKIO_a260a111}
}]The time the file was created. \index{UDS_FILE_TYPE@{UDS\_\-FILE\_\-TYPE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_FILE_TYPE@{UDS\_\-FILE\_\-TYPE}}\item[{\em 
UDS\_\-FILE\_\-TYPE\label{namespaceKIO_a260a112}
}]File type, part of the mode returned by stat (for a link, this returns the file type of the pointed item) check UDS\_\-LINK\_\-DEST to know if this is a link. \index{UDS_LINK_DEST@{UDS\_\-LINK\_\-DEST}!KIO@{KIO}}\index{KIO@{KIO}!UDS_LINK_DEST@{UDS\_\-LINK\_\-DEST}}\item[{\em 
UDS\_\-LINK\_\-DEST\label{namespaceKIO_a260a113}
}]Name of the file where the link points to Allows to check for a symlink (don't use S\_\-ISLNK !). \index{UDS_URL@{UDS\_\-URL}!KIO@{KIO}}\index{KIO@{KIO}!UDS_URL@{UDS\_\-URL}}\item[{\em 
UDS\_\-URL\label{namespaceKIO_a260a114}
}]An alternative URL (If different from the caption). \index{UDS_MIME_TYPE@{UDS\_\-MIME\_\-TYPE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_MIME_TYPE@{UDS\_\-MIME\_\-TYPE}}\item[{\em 
UDS\_\-MIME\_\-TYPE\label{namespaceKIO_a260a115}
}]A mime type; prevents guessing. \index{UDS_GUESSED_MIME_TYPE@{UDS\_\-GUESSED\_\-MIME\_\-TYPE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_GUESSED_MIME_TYPE@{UDS\_\-GUESSED\_\-MIME\_\-TYPE}}\item[{\em 
UDS\_\-GUESSED\_\-MIME\_\-TYPE\label{namespaceKIO_a260a116}
}]A mime type to be used for displaying only. 

But when 'running' the file, the mimetype is re-determined \index{UDS_XML_PROPERTIES@{UDS\_\-XML\_\-PROPERTIES}!KIO@{KIO}}\index{KIO@{KIO}!UDS_XML_PROPERTIES@{UDS\_\-XML\_\-PROPERTIES}}\item[{\em 
UDS\_\-XML\_\-PROPERTIES\label{namespaceKIO_a260a117}
}]XML properties, e.g. 

for Web\-DAV \begin{Desc}
\item[Since:]3.1 \end{Desc}
\end{description}
\end{Desc}



Definition at line 297 of file global.h.\index{KIO@{KIO}!CacheControl@{CacheControl}}
\index{CacheControl@{CacheControl}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Cache\-Control}}\label{namespaceKIO_a261}


Specifies how to use the cache. 

\begin{Desc}
\item[See also:]{\bf parse\-Cache\-Control()}{\rm (p.\,\pageref{namespaceKIO_a199})} 

{\bf get\-Cache\-Control\-String()}{\rm (p.\,\pageref{namespaceKIO_a200})} \end{Desc}
\begin{Desc}
\item[Enumeration values: ]\par
\begin{description}
\index{CC_CacheOnly@{CC\_\-CacheOnly}!KIO@{KIO}}\index{KIO@{KIO}!CC_CacheOnly@{CC\_\-CacheOnly}}\item[{\em 
CC\_\-Cache\-Only\label{namespaceKIO_a261a118}
}]Fail request if not in cache. \index{CC_Cache@{CC\_\-Cache}!KIO@{KIO}}\index{KIO@{KIO}!CC_Cache@{CC\_\-Cache}}\item[{\em 
CC\_\-Cache\label{namespaceKIO_a261a119}
}]Use cached entry if available. \index{CC_Verify@{CC\_\-Verify}!KIO@{KIO}}\index{KIO@{KIO}!CC_Verify@{CC\_\-Verify}}\item[{\em 
CC\_\-Verify\label{namespaceKIO_a261a120}
}]Validate cached entry with remote site if expired. \index{CC_Refresh@{CC\_\-Refresh}!KIO@{KIO}}\index{KIO@{KIO}!CC_Refresh@{CC\_\-Refresh}}\item[{\em 
CC\_\-Refresh\label{namespaceKIO_a261a121}
}]Always validate cached entry with remote site \begin{Desc}
\item[Since:]3.1. \end{Desc}
\index{CC_Reload@{CC\_\-Reload}!KIO@{KIO}}\index{KIO@{KIO}!CC_Reload@{CC\_\-Reload}}\item[{\em 
CC\_\-Reload\label{namespaceKIO_a261a122}
}]Always fetch from remote site. \end{description}
\end{Desc}



Definition at line 363 of file global.h.\index{KIO@{KIO}!RenameDlg_Result@{RenameDlg\_\-Result}}
\index{RenameDlg_Result@{RenameDlg\_\-Result}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Rename\-Dlg\_\-Result}}\label{namespaceKIO_a265}


The result of open\_\-Rename\-Dlg(). 



Definition at line 40 of file renamedlg.h.\index{KIO@{KIO}!Info@{Info}}
\index{Info@{Info}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Info}}\label{namespaceKIO_a267}


Identifiers for KIO informational messages. 



Definition at line 44 of file slaveinterface.h.\index{KIO@{KIO}!Message@{Message}}
\index{Message@{Message}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Message}}\label{namespaceKIO_a268}


Identifiers for KIO data messages. 



Definition at line 64 of file slaveinterface.h.

\subsection{Function Documentation}
\index{KIO@{KIO}!chmod@{chmod}}
\index{chmod@{chmod}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf Chmod\-Job} $\ast$ KIO::chmod (const {\bf KFile\-Item\-List} \& {\em lst\-Items}, int {\em permissions}, int {\em mask}, {\bf QString} {\em new\-Owner}, {\bf QString} {\em new\-Group}, bool {\em recursive}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a182}


Creates a job that changes permissions/ownership on several files or directories, optionally recursively. 

This version of chmod uses a KFile\-Item\-List so that it directly knows what to do with the items. TODO: a version that takes a {\bf KURL::List}, and a general job that stats each url and returns a KFile\-Item\-List.

Note that change of ownership is only supported for local files.

Inside directories, the \char`\"{}x\char`\"{} bits will only be changed for files that had at least one \char`\"{}x\char`\"{} bit before, and for directories. This emulates the behavior of chmod +X.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em lst\-Items}]The file items representing several files or directories. \item[{\em permissions}]the permissions we want to set \item[{\em mask}]the bits we are allowed to change. For instance, if mask is 0077, we don't change the \char`\"{}user\char`\"{} bits, only \char`\"{}group\char`\"{} and \char`\"{}others\char`\"{}. \item[{\em new\-Owner}]If non-empty, the new owner for the files \item[{\em new\-Group}]If non-empty, the new group for the files \item[{\em recursive}]whether to open directories recursively \item[{\em show\-Progress\-Info}]true to show progess information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The job handling the operation. \end{Desc}


Definition at line 223 of file chmodjob.cpp.

References endl(), QString::is\-Empty(), and kd\-Error().

Referenced by KFile\-Permissions\-Props\-Plugin::apply\-Changes(), and KIO::Forwarding\-Slave\-Base::chmod().\index{KIO@{KIO}!davPropFind@{davPropFind}}
\index{davPropFind@{davPropFind}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Dav\-Job} $\ast$ KIO::dav\-Prop\-Find (const {\bf KURL} \& {\em url}, const {\bf QDom\-Document} \& {\em properties}, {\bf QString} {\em depth}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a183}


Creates a new {\bf Dav\-Job}{\rm (p.\,\pageref{classKIO_1_1DavJob})} that issues a PROPFIND command. 

PROPFIND retrieves the properties of the resource identified by the given {\tt url}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the resource \item[{\em properties}]a propfind document that describes the properties that should be retrieved \item[{\em depth}]the depth of the request. Can be \char`\"{}0\char`\"{}, \char`\"{}1\char`\"{} or \char`\"{}infinity\char`\"{} \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the new {\bf Dav\-Job}{\rm (p.\,\pageref{classKIO_1_1DavJob})} \end{Desc}


Definition at line 117 of file davjob.cpp.

References KIO::Job::add\-Meta\-Data().\index{KIO@{KIO}!davPropPatch@{davPropPatch}}
\index{davPropPatch@{davPropPatch}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Dav\-Job} $\ast$ KIO::dav\-Prop\-Patch (const {\bf KURL} \& {\em url}, const {\bf QDom\-Document} \& {\em properties}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a184}


Creates a new {\bf Dav\-Job}{\rm (p.\,\pageref{classKIO_1_1DavJob})} that issues a PROPPATCH command. 

PROPPATCH sets the properties of the resource identified by the given {\tt url}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the resource \item[{\em properties}]a PROPPACTCH document that describes the properties that should be modified and its new values \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the new {\bf Dav\-Job}{\rm (p.\,\pageref{classKIO_1_1DavJob})} \end{Desc}


Definition at line 125 of file davjob.cpp.\index{KIO@{KIO}!davSearch@{davSearch}}
\index{davSearch@{davSearch}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Dav\-Job} $\ast$ KIO::dav\-Search (const {\bf KURL} \& {\em url}, const {\bf QString} \& {\em ns\-URI}, const {\bf QString} \& {\em q\-Name}, const {\bf QString} \& {\em query}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a185}


Creates a new {\bf Dav\-Job}{\rm (p.\,\pageref{classKIO_1_1DavJob})} that issues a SEARCH command. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the resource \item[{\em ns\-URI}]the URI of the search method's qualified name \item[{\em q\-Name}]the local part of the search method's qualified name \item[{\em query}]the search string \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the new {\bf Dav\-Job}{\rm (p.\,\pageref{classKIO_1_1DavJob})} \end{Desc}


Definition at line 130 of file davjob.cpp.

References QDom\-Document::create\-Element\-NS(), QDom\-Document::create\-Text\-Node(), and QDom\-Document::to\-String().\index{KIO@{KIO}!convertSize@{convertSize}}
\index{convertSize@{convertSize}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::convert\-Size ({\bf KIO::filesize\_\-t} {\em size})}\label{namespaceKIO_a186}


Converts {\tt size} from bytes to the string representation. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em size}]size in bytes \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]converted size as a string - e.g. 123.4 k\-B , 12.0 MB \end{Desc}


Definition at line 45 of file global.cpp.

References QString::arg().

Referenced by convert\-Size\-From\-KB(), and KFile\-Mime\-Type\-Info::Item\-Info::string().\index{KIO@{KIO}!number@{number}}
\index{number@{number}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::number ({\bf KIO::filesize\_\-t} {\em size})}\label{namespaceKIO_a187}


Converts a size to a string representation Not unlike {\bf QString::number}(...). 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em size}]size in bytes \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]converted size as a string - e.g. 123456789 \end{Desc}


Definition at line 83 of file global.cpp.

References QString::from\-Latin1().

Referenced by KIO::Slave\-Base::can\-Resume(), and KFile\-View::sorting\-Key().\index{KIO@{KIO}!convertSizeFromKB@{convertSizeFromKB}}
\index{convertSizeFromKB@{convertSizeFromKB}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::convert\-Size\-From\-KB ({\bf KIO::filesize\_\-t} {\em kb\-Size})}\label{namespaceKIO_a188}


Converts size from kilo-bytes to the string representation. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em kb\-Size}]size in kilo-bytes \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]converted size as a string - e.g. 123.4 k\-B , 12.0 MB \end{Desc}


Definition at line 78 of file global.cpp.

References convert\-Size().

Referenced by KFile\-Mime\-Type\-Info::Item\-Info::string().\index{KIO@{KIO}!calculateRemainingSeconds@{calculateRemainingSeconds}}
\index{calculateRemainingSeconds@{calculateRemainingSeconds}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT unsigned int KIO::calculate\-Remaining\-Seconds ({\bf KIO::filesize\_\-t} {\em total\-Size}, {\bf KIO::filesize\_\-t} {\em processed\-Size}, {\bf KIO::filesize\_\-t} {\em speed})}\label{namespaceKIO_a189}


Calculates remaining time in seconds from total size, processed size and speed. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em total\-Size}]total size in bytes \item[{\em processed\-Size}]processed size in bytes \item[{\em speed}]speed in bytes per second \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]calculated remaining time in seconds\end{Desc}
\begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 90 of file global.cpp.\index{KIO@{KIO}!convertSeconds@{convertSeconds}}
\index{convertSeconds@{convertSeconds}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::convert\-Seconds (unsigned int {\em seconds})}\label{namespaceKIO_a190}


Convert {\tt seconds} to a string representing number of days, hours, minutes and seconds. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em seconds}]number of seconds to convert \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]string representation in a locale depending format\end{Desc}
\begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 99 of file global.cpp.

References QString::arg().\index{KIO@{KIO}!calculateRemaining@{calculateRemaining}}
\index{calculateRemaining@{calculateRemaining}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QTime} KIO::calculate\-Remaining ({\bf KIO::filesize\_\-t} {\em total\-Size}, {\bf KIO::filesize\_\-t} {\em processed\-Size}, {\bf KIO::filesize\_\-t} {\em speed})}\label{namespaceKIO_a191}


Calculates remaining time from total size, processed size and speed. 

Warning: As {\bf QTime} is limited to 23:59:59, use {\bf calculate\-Remaining\-Seconds()}{\rm (p.\,\pageref{namespaceKIO_a189})} instead

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em total\-Size}]total size in bytes \item[{\em processed\-Size}]processed size in bytes \item[{\em speed}]speed in bytes per second \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]calculated remaining time \end{Desc}


Definition at line 114 of file global.cpp.

References QTime::set\-HMS().\index{KIO@{KIO}!itemsSummaryString@{itemsSummaryString}}
\index{itemsSummaryString@{itemsSummaryString}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::items\-Summary\-String (uint {\em items}, uint {\em files}, uint {\em dirs}, {\bf KIO::filesize\_\-t} {\em size}, bool {\em show\-Size})}\label{namespaceKIO_a192}


Helper for showing information about a set of files and directories. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]the number of items (= {\tt files} + {\tt dirs} + number of symlinks :) \item[{\em files}]the number of files \item[{\em dirs}]the number of dirs \item[{\em size}]the sum of the size of the {\tt files} \item[{\em show\-Size}]whether to show the size in the result \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the summary string \end{Desc}


Definition at line 137 of file global.cpp.

References QString::arg().\index{KIO@{KIO}!encodeFileName@{encodeFileName}}
\index{encodeFileName@{encodeFileName}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::encode\-File\-Name (const {\bf QString} \& {\em str})}\label{namespaceKIO_a193}


Encodes (from the text displayed to the real filename) This translates  into \% and / into 2f Used by {\bf KIO::link}{\rm (p.\,\pageref{namespaceKIO_a235})}, for instance. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em str}]the file name to encode \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the encoded file name \end{Desc}


Definition at line 152 of file global.cpp.

References QString::find(), and QString::replace().

Referenced by KFile\-Props\-Plugin::apply\-Changes().\index{KIO@{KIO}!decodeFileName@{decodeFileName}}
\index{decodeFileName@{decodeFileName}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::decode\-File\-Name (const {\bf QString} \& {\em str})}\label{namespaceKIO_a194}


Decodes (from the filename to the text displayed) This translates 2[f\-F] into / and \% into . 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em str}]the file name to decode \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the decoded file name \end{Desc}


Definition at line 167 of file global.cpp.

References QString::append().

Referenced by KFile\-Item::read\-UDSEntry(), and KFile\-Item::set\-Name().\index{KIO@{KIO}!buildErrorString@{buildErrorString}}
\index{buildErrorString@{buildErrorString}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::build\-Error\-String (int {\em error\-Code}, const {\bf QString} \& {\em error\-Text})}\label{namespaceKIO_a195}


Returns a translated error message for {\tt error\-Code} using the additional error information provided by {\tt error\-Text}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em error\-Code}]the error code \item[{\em error\-Text}]the additional error text \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the created error string \end{Desc}


Definition at line 200 of file global.cpp.

References QString::arg(), QString::from\-Latin1(), and QString::is\-Empty().

Referenced by KIO::Job::error\-String(), and raw\-Error\-Detail().\index{KIO@{KIO}!buildHTMLErrorString@{buildHTMLErrorString}}
\index{buildHTMLErrorString@{buildHTMLErrorString}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} build\-HTMLError\-String (int {\em error\-Code}, const {\bf QString} \& {\em error\-Text}, const {\bf KURL} $\ast$ {\em req\-Url} = {\tt 0L}, int {\em method} = {\tt -1})}\label{namespaceKIO_a196}


Returns a translated html error message for {\tt error\-Code} using the additional error information provided by {\tt error\-Text} , {\tt req\-Url} (the request URL), and the ioslave {\tt method} . 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em error\-Code}]the error code \item[{\em error\-Text}]the additional error text \item[{\em req\-Url}]the request URL \item[{\em method}]the ioslave method \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the created error string \end{Desc}
\index{KIO@{KIO}!rawErrorDetail@{rawErrorDetail}}
\index{rawErrorDetail@{rawErrorDetail}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QByte\-Array} KIO::raw\-Error\-Detail (int {\em error\-Code}, const {\bf QString} \& {\em error\-Text}, const {\bf KURL} $\ast$ {\em req\-Url} = {\tt 0L}, int {\em method} = {\tt -1})}\label{namespaceKIO_a197}


Returns translated error details for {\tt error\-Code} using the additional error information provided by {\tt error\-Text} , {\tt req\-Url} (the request URL), and the ioslave {\tt method} . 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em error\-Code}]the error code \item[{\em error\-Text}]the additional error text \item[{\em req\-Url}]the request URL \item[{\em method}]the ioslave method \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the following data: \begin{itemize}
\item {\bf QString} error\-Name - the name of the error \item {\bf QString} tech\-Name - if not null, the more technical name of the error \item {\bf QString} description - a description of the error \item {\bf QString\-List} causes - a list of possible causes of the error \item {\bf QString\-List} solutions - a liso of solutions for the error \end{itemize}
\end{Desc}


Definition at line 495 of file global.cpp.

References QString::arg(), build\-Error\-String(), KLocale::format\-Date\-Time(), QString::is\-Null(), QString::left(), KGlobal::locale(), and QString::mid().

Referenced by KIO::Job::detailed\-Error\-Strings().\index{KIO@{KIO}!unsupportedActionErrorString@{unsupportedActionErrorString}}
\index{unsupportedActionErrorString@{unsupportedActionErrorString}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf QString} KIO::unsupported\-Action\-Error\-String (const {\bf QString} \& {\em protocol}, int {\em cmd})}\label{namespaceKIO_a198}


Returns an appropriate error message if the given command {\tt cmd} is an unsupported action (ERR\_\-UNSUPPORTED\_\-ACTION). 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em protocol}]name of the protocol \item[{\em cmd}]given command \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]enum {\bf Command}{\rm (p.\,\pageref{namespaceKIO_a258})} \end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 406 of file global.cpp.

References QString::arg().

Referenced by KIO::Slave\-Base::chmod(), KIO::Slave\-Base::copy(), KIO::Slave\-Base::del(), KIO::Slave\-Base::get(), KIO::Slave\-Base::list\-Dir(), KIO::Slave\-Base::mkdir(), KIO::Slave\-Base::multi\-Get(), KIO::Slave\-Base::open\-Connection(), KIO::Slave\-Base::put(), KIO::Slave\-Base::rename(), KIO::Slave\-Base::set\-Sub\-URL(), KIO::Slave\-Base::special(), KIO::Slave\-Base::stat(), and KIO::Slave\-Base::symlink().\index{KIO@{KIO}!parseCacheControl@{parseCacheControl}}
\index{parseCacheControl@{parseCacheControl}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KIO::Cache\-Control} KIO::parse\-Cache\-Control (const {\bf QString} \& {\em cache\-Control})}\label{namespaceKIO_a199}


Parses the string representation of the cache control option. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em cache\-Control}]the string representation \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the cache control value \end{Desc}
\begin{Desc}
\item[See also:]{\bf get\-Cache\-Control\-String()}{\rm (p.\,\pageref{namespaceKIO_a200})} \end{Desc}


Definition at line 1947 of file global.cpp.

References endl(), and kd\-Debug().

Referenced by KProtocol\-Manager::cache\-Control().\index{KIO@{KIO}!getCacheControlString@{getCacheControlString}}
\index{getCacheControlString@{getCacheControlString}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::get\-Cache\-Control\-String ({\bf KIO::Cache\-Control} {\em cache\-Control})}\label{namespaceKIO_a200}


Returns a string representation of the given cache control method. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em cache\-Control}]the cache control method \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the string representation \end{Desc}
\begin{Desc}
\item[See also:]{\bf parse\-Cache\-Control()}{\rm (p.\,\pageref{namespaceKIO_a199})} \end{Desc}


Definition at line 1966 of file global.cpp.

References endl(), and kd\-Debug().\index{KIO@{KIO}!findDeviceMountPoint@{findDeviceMountPoint}}
\index{findDeviceMountPoint@{findDeviceMountPoint}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::find\-Device\-Mount\-Point (const {\bf QString} \& {\em device})}\label{namespaceKIO_a201}


Returns the mount point where {\tt device} is mounted right now. 

This means, it has to be mounted, not just defined in fstab. 

Definition at line 1883 of file global.cpp.

Referenced by KDEDesktop\-Mime\-Type::builtin\-Services(), KDEDesktop\-Mime\-Type::execute\-Service(), and KDEDesktop\-Mime\-Type::icon().\index{KIO@{KIO}!findPathMountPoint@{findPathMountPoint}}
\index{findPathMountPoint@{findPathMountPoint}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::find\-Path\-Mount\-Point (const {\bf QString} \& {\em filename})}\label{namespaceKIO_a202}


Returns the mount point on which resides {\tt filename}. 

Q\_\-OS\_\-UNIX 

Definition at line 1889 of file global.cpp.

Referenced by KDisk\-Free\-Sp::find\-Usage\-Info(), and KFile\-Props\-Plugin::KFile\-Props\-Plugin().\index{KIO@{KIO}!probably_slow_mounted@{probably\_\-slow\_\-mounted}}
\index{probably_slow_mounted@{probably\_\-slow\_\-mounted}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KIO::probably\_\-slow\_\-mounted (const {\bf QString} \& {\em filename})}\label{namespaceKIO_a203}


Checks if the path belongs to a filesystem that is probably slow. 

Q\_\-OS\_\-UNIX 

Definition at line 1912 of file global.cpp.

References QString::is\-Null().\index{KIO@{KIO}!manually_mounted@{manually\_\-mounted}}
\index{manually_mounted@{manually\_\-mounted}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KIO::manually\_\-mounted (const {\bf QString} \& {\em filename})}\label{namespaceKIO_a204}


Checks if the path belongs to a filesystem that is manually mounted. 

Q\_\-OS\_\-UNIX 

Definition at line 1900 of file global.cpp.

References QString::is\-Null().\index{KIO@{KIO}!testFileSystemFlag@{testFileSystemFlag}}
\index{testFileSystemFlag@{testFileSystemFlag}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KIO::test\-File\-System\-Flag (const {\bf QString} \& {\em filename}, File\-System\-Flag {\em flag})}\label{namespaceKIO_a205}


Checks the capabilities of the filesystem to which a given file belongs. 

given feature (e.g. chmod). \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em filename}]the file name to check \item[{\em flag}]the flag to check \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if the filesystem has that flag, false if not (or some error occurred)\end{Desc}
The availables flags are: \begin{itemize}
\item Supports\-Chmod: returns true if the filesystem supports chmod (e.g. msdos filesystems return false) \item Supports\-Chown: returns true if the filesystem supports chown (e.g. msdos filesystems return false) \item Supports\-Utime: returns true if the filesystems supports utime (e.g. msdos filesystems return false) \item Supports\-Symlinks: returns true if the filesystems supports symlinks (e.g. msdos filesystems return false) \item Case\-Insensitive: returns true if the filesystem treats \char`\"{}foo\char`\"{} and \char`\"{}FOO\char`\"{} as being the same file (true for msdos systems) \end{itemize}


Definition at line 1924 of file global.cpp.

References endl(), QString::is\-Null(), and kd\-Debug().\index{KIO@{KIO}!mkdir@{mkdir}}
\index{mkdir@{mkdir}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::mkdir (const {\bf KURL} \& {\em url}, int {\em permissions} = {\tt -1})}\label{namespaceKIO_a206}


Creates a single directory. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL of the directory to create. \item[{\em permissions}]The permissions to set after creating the directory (unix-style), -1 for default permissions. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A pointer to the job handling the operation. \end{Desc}


Definition at line 692 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::mkdir().\index{KIO@{KIO}!rmdir@{rmdir}}
\index{rmdir@{rmdir}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::rmdir (const {\bf KURL} \& {\em url})}\label{namespaceKIO_a207}


Removes a single directory. 

The directory is assumed to be empty.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL of the directory to remove. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A pointer to the job handling the operation. \end{Desc}


Definition at line 699 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::del().\index{KIO@{KIO}!chmod@{chmod}}
\index{chmod@{chmod}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::chmod (const {\bf KURL} \& {\em url}, int {\em permissions})}\label{namespaceKIO_a208}


Changes permissions on a file or directory. 

See the other chmod below for changing many files or directories.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL of file or directory. \item[{\em permissions}]The permissions to set. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 706 of file job.cpp.\index{KIO@{KIO}!rename@{rename}}
\index{rename@{rename}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::rename (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em overwrite})}\label{namespaceKIO_a209}


Rename a file or directory. 

Warning: this operation fails if a direct renaming is not possible (like with files or dirs on separate partitions) Use move or file\_\-move in this case.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]The original URL \item[{\em dest}]The final URL \item[{\em overwrite}]whether to automatically overwrite if the dest exists \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 713 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::rename().\index{KIO@{KIO}!symlink@{symlink}}
\index{symlink@{symlink}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::symlink (const {\bf QString} \& {\em target}, const {\bf KURL} \& {\em dest}, bool {\em overwrite}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a210}


Create or move a symlink. 

This is the lowlevel operation, similar to file\_\-copy and file\_\-move. It doesn't do any check (other than those the slave does) and it doesn't show rename and skip dialogs - use {\bf KIO::link}{\rm (p.\,\pageref{namespaceKIO_a235})} for that. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em target}]The string that will become the \char`\"{}target\char`\"{} of the link (can be relative) \item[{\em dest}]The symlink to create. \item[{\em overwrite}]whether to automatically overwrite if the dest exists \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 720 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::symlink().\index{KIO@{KIO}!special@{special}}
\index{special@{special}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::special (const {\bf KURL} \& {\em url}, const {\bf QByte\-Array} \& {\em data}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a211}


Execute any command that is specific to one slave (protocol). 

Examples are : HTTP POST, mount and unmount (kio\_\-file)

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL isn't passed to the slave, but is used to know which slave to send it to :-) \item[{\em data}]Packed data. The meaning is completely dependent on the slave, but usually starts with an int for the command number. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 727 of file job.cpp.

Referenced by mount(), and unmount().\index{KIO@{KIO}!mount@{mount}}
\index{mount@{mount}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::mount (bool {\em ro}, const char $\ast$ {\em fstype}, const {\bf QString} \& {\em dev}, const {\bf QString} \& {\em point}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a212}


Mount filesystem. 

Special job for {\tt kio\_\-file}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em ro}]Mount read-only if {\tt true}. \item[{\em fstype}]File system type (e.g. \char`\"{}ext2\char`\"{}, can be 0L). \item[{\em dev}]Device (e.g. /dev/sda0). \item[{\em point}]Mount point, can be {\tt null}. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 733 of file job.cpp.

References QString::from\-Latin1(), Observer::mounting(), Observer::self(), and special().\index{KIO@{KIO}!unmount@{unmount}}
\index{unmount@{unmount}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::unmount (const {\bf QString} \& {\em point}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a213}


Unmount filesystem. 

Special job for {\tt kio\_\-file}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em point}]Point to unmount. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 743 of file job.cpp.

References Observer::self(), special(), and Observer::unmounting().\index{KIO@{KIO}!http_update_cache@{http\_\-update\_\-cache}}
\index{http_update_cache@{http\_\-update\_\-cache}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::http\_\-update\_\-cache (const {\bf KURL} \& {\em url}, bool {\em no\_\-cache}, time\_\-t {\em expire\-Date})}\label{namespaceKIO_a214}


HTTP cache update. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]Url to update, protocol must be \char`\"{}http\char`\"{}. \item[{\em no\_\-cache}]If true, cache entry for {\tt url} is deleted. \item[{\em expire\-Date}]Local machine time indicating when the entry is supposed to expire. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 845 of file job.cpp.

References KIO::Scheduler::schedule\-Job().\index{KIO@{KIO}!stat@{stat}}
\index{stat@{stat}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Stat\-Job} $\ast$ KIO::stat (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a215}


Find all details for one file or directory. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the file \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 827 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::stat().\index{KIO@{KIO}!stat@{stat}}
\index{stat@{stat}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Stat\-Job} $\ast$ KIO::stat (const {\bf KURL} \& {\em url}, bool {\em side\-Is\-Source}, short int {\em details}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a216}


Find all details for one file or directory. 

This version of the call includes two additional booleans, {\tt side\-Is\-Source} and {\tt details}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the file \item[{\em side\-Is\-Source}]is true when stating a source file (we will do a get on it if the stat works) and false when stating a destination file (target of a copy). The reason for this parameter is that in some cases the kioslave might not be able to determine a file's existence (e.g. HTTP doesn't allow it, FTP has issues with case-sensitivity on some systems). When the slave can't reliably determine the existence of a file, it will: \begin{itemize}
\item be optimistic if side\-Is\-Source=true, i.e. it will assume the file exists, and if it doesn't this will appear when actually trying to download it \item be pessimistic if side\-Is\-Source=false, i.e. it will assume the file doesn't exist, to prevent showing \char`\"{}about to overwrite\char`\"{} errors to the user. If you simply want to check for existence without downloading/uploading afterwards, then you should use side\-Is\-Source=false.\end{itemize}
\item[{\em details}]selects the level of details we want. By default this is 2 (all details wanted, including modification time, size, etc.), set\-Details(1) is used when deleting: we don't need all the information if it takes too much time, no need to follow symlinks etc. set\-Details(0) is used for very simple probing: we'll only get the answer \char`\"{}it's a file or a directory, or it doesn't exist\char`\"{}. This is used by {\bf KRun}{\rm (p.\,\pageref{classKRun})}. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 833 of file job.cpp.

References endl(), kd\-Debug(), Observer::self(), KIO::Stat\-Job::set\-Details(), KIO::Stat\-Job::set\-Side(), and Observer::stating().\index{KIO@{KIO}!get@{get}}
\index{get@{get}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Transfer\-Job} $\ast$ KIO::get (const {\bf KURL} \& {\em url}, bool {\em reload} = {\tt false}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a217}


Get (a.k.a. 

read).

The slave emits the data through data(). \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the file \item[{\em reload}]true to reload the file, false if it can be taken from the cache \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 1161 of file job.cpp.

References KIO::Job::add\-Meta\-Data().

Referenced by KIO::Forwarding\-Slave\-Base::get().\index{KIO@{KIO}!put@{put}}
\index{put@{put}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Transfer\-Job} $\ast$ KIO::put (const {\bf KURL} \& {\em url}, int {\em permissions}, bool {\em overwrite}, bool {\em resume}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a218}


Put (a.k.a. 

write)

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]Where to write data. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If true, any existing file will be overwritten. \item[{\em resume}]true to resume an operation. Warning, setting this to true means that the data will be appended to {\tt dest} if {\tt dest} exists. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}
\begin{Desc}
\item[See also:]{\bf multi\_\-get()}{\rm (p.\,\pageref{namespaceKIO_a222})} \end{Desc}


Definition at line 1321 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::put().\index{KIO@{KIO}!http_post@{http\_\-post}}
\index{http_post@{http\_\-post}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Transfer\-Job} $\ast$ KIO::http\_\-post (const {\bf KURL} \& {\em url}, const {\bf QByte\-Array} \& {\em post\-Data}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a219}


HTTP POST (for form data). 

Example: 

\footnotesize\begin{verbatim}    job = KIO::http_post( url, postData, false );
    job->addMetaData("content-type", contentType );
    job->addMetaData("referrer", referrerURL);
\end{verbatim}
\normalsize


{\tt post\-Data} is the data that you want to send and {\tt content\-Type} is the complete HTTP header line that specifies the content's MIME type, for example \char`\"{}Content-Type: text/xml\char`\"{}.

You MUST specify content-type!

Often {\tt content\-Type} is \char`\"{}Content-Type: application/x-www-form-urlencoded\char`\"{} and the {\tt post\-Data} is then an ASCII string (without null-termination!) with characters like space, linefeed and percent escaped like 20, 0A and 25.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]Where to write the data. \item[{\em post\-Data}]Encoded data to post. \item[{\em show\-Progress\-Info}]true to display \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 1184 of file job.cpp.

References QValue\-List::begin(), QValue\-List::contains(), QValue\-List::end(), QString::is\-Empty(), KURL::path(), KConfig\-Base::read\-Int\-List\-Entry(), KURL::set\-Path(), and QTimer::single\-Shot().\index{KIO@{KIO}!storedGet@{storedGet}}
\index{storedGet@{storedGet}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Stored\-Transfer\-Job} $\ast$ KIO::stored\-Get (const {\bf KURL} \& {\em url}, bool {\em reload} = {\tt false}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a220}


Get (a.k.a. 

read), into a single {\bf QByte\-Array}. \begin{Desc}
\item[See also:]{\bf Stored\-Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1StoredTransferJob})}\end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the file \item[{\em reload}]true to reload the file, false if it can be taken from the cache \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}
\begin{Desc}
\item[Since:]3.3 \end{Desc}


Definition at line 1382 of file job.cpp.

References KIO::Job::add\-Meta\-Data().\index{KIO@{KIO}!storedPut@{storedPut}}
\index{storedPut@{storedPut}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Stored\-Transfer\-Job} $\ast$ KIO::stored\-Put (const {\bf QByte\-Array} \& {\em arr}, const {\bf KURL} \& {\em url}, int {\em permissions}, bool {\em overwrite}, bool {\em resume}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a221}


Put (a.k.a. 

write) data from a single {\bf QByte\-Array}. \begin{Desc}
\item[See also:]{\bf Stored\-Transfer\-Job}{\rm (p.\,\pageref{classKIO_1_1StoredTransferJob})}\end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em arr}]The data to write \item[{\em url}]Where to write data. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If true, any existing file will be overwritten. \item[{\em resume}]true to resume an operation. Warning, setting this to true means that the data will be appended to {\tt dest} if {\tt dest} exists. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}
\begin{Desc}
\item[Since:]3.3 \end{Desc}


Definition at line 1392 of file job.cpp.

References KIO::Stored\-Transfer\-Job::set\-Data().\index{KIO@{KIO}!multi_get@{multi\_\-get}}
\index{multi_get@{multi\_\-get}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Multi\-Get\-Job} $\ast$ KIO::multi\_\-get (long {\em id}, const {\bf KURL} \& {\em url}, const {\bf Meta\-Data} \& {\em meta\-Data})}\label{namespaceKIO_a222}


Creates a new multiple get job. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em id}]the id of the get operation \item[{\em url}]the URL of the file \item[{\em meta\-Data}]the {\bf Meta\-Data}{\rm (p.\,\pageref{classKIO_1_1MetaData})} associated with the file\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}
\begin{Desc}
\item[See also:]{\bf get()}{\rm (p.\,\pageref{namespaceKIO_a217})} \end{Desc}


Definition at line 4387 of file job.cpp.

References KIO::Multi\-Get\-Job::get(), and KIO::Multi\-Get\-Job::Multi\-Get\-Job().\index{KIO@{KIO}!mimetype@{mimetype}}
\index{mimetype@{mimetype}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Mimetype\-Job} $\ast$ KIO::mimetype (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a223}


Find mimetype for one file or directory. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the URL of the file \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 1450 of file job.cpp.

References Observer::self(), and Observer::stating().

Referenced by KIO::Forwarding\-Slave\-Base::mimetype(), and KIO::Forwarding\-Slave\-Base::prepare\-UDSEntry().\index{KIO@{KIO}!file_copy@{file\_\-copy}}
\index{file_copy@{file\_\-copy}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf File\-Copy\-Job} $\ast$ KIO::file\_\-copy (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, int {\em permissions} = {\tt -1}, bool {\em overwrite} = {\tt false}, bool {\em resume} = {\tt false}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a224}


Copy a single file. 

Uses either {\bf Slave\-Base::copy()}{\rm (p.\,\pageref{classKIO_1_1SlaveBase_a48})} if the slave supports that or {\bf get()}{\rm (p.\,\pageref{namespaceKIO_a217})} and {\bf put()}{\rm (p.\,\pageref{namespaceKIO_a218})} otherwise. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]Where to get the file. \item[{\em dest}]Where to put the file. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If true, any existing file will be overwritten. \item[{\em resume}]true to resume an operation. Warning, setting this to true means that {\tt src} will be appended to {\tt dest} if {\tt dest} exists. You probably don't want that, so leave it to false :)\item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 1884 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::copy().\index{KIO@{KIO}!file_move@{file\_\-move}}
\index{file_move@{file\_\-move}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf File\-Copy\-Job} $\ast$ KIO::file\_\-move (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, int {\em permissions} = {\tt -1}, bool {\em overwrite} = {\tt false}, bool {\em resume} = {\tt false}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a225}


Move a single file. 

Use either {\bf Slave\-Base::rename()}{\rm (p.\,\pageref{classKIO_1_1SlaveBase_a45})} if the slave supports that, or {\bf copy()}{\rm (p.\,\pageref{namespaceKIO_a229})} and {\bf del()}{\rm (p.\,\pageref{namespaceKIO_a240})} otherwise, or eventually {\bf get()}{\rm (p.\,\pageref{namespaceKIO_a217})} \& {\bf put()}{\rm (p.\,\pageref{namespaceKIO_a218})} \& {\bf del()}{\rm (p.\,\pageref{namespaceKIO_a240})} \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]Where to get the file. \item[{\em dest}]Where to put the file. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If {\tt true}, any existing file will be overwritten. \item[{\em resume}]true to resume an operation. Warning, setting this to true means that {\tt src} will be appended to {\tt dest} if {\tt dest} exists. You probably don't want that, so leave it to false :) \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 1890 of file job.cpp.\index{KIO@{KIO}!file_delete@{file\_\-delete}}
\index{file_delete@{file\_\-delete}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::file\_\-delete (const {\bf KURL} \& {\em src}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a226}


Delete a single file. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]File to delete. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 1896 of file job.cpp.\index{KIO@{KIO}!listDir@{listDir}}
\index{listDir@{listDir}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf List\-Job} $\ast$ KIO::list\-Dir (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = {\tt true}, bool {\em include\-Hidden} = {\tt true})}\label{namespaceKIO_a227}


List the contents of {\tt url}, which is assumed to be a directory. 

\char`\"{}.\char`\"{} and \char`\"{}..\char`\"{} are returned, filter them out if you don't want them.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the url of the directory \item[{\em show\-Progress\-Info}]true to show progress information \item[{\em include\-Hidden}]true for all files, false to cull out UNIX hidden files/dirs (whose names start with dot) \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 2073 of file job.cpp.

Referenced by KIO::Forwarding\-Slave\-Base::list\-Dir().\index{KIO@{KIO}!listRecursive@{listRecursive}}
\index{listRecursive@{listRecursive}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf List\-Job} $\ast$ KIO::list\-Recursive (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = {\tt true}, bool {\em include\-Hidden} = {\tt true})}\label{namespaceKIO_a228}


The same as the previous method, but recurses subdirectories. 

Directory links are not followed.

\char`\"{}.\char`\"{} and \char`\"{}..\char`\"{} are returned but only for the toplevel directory. Filter them out if you don't want them.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the url of the directory \item[{\em show\-Progress\-Info}]true to show progress information \item[{\em include\-Hidden}]true for all files, false to cull out UNIX hidden files/dirs (whose names start with dot) \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation. \end{Desc}


Definition at line 2079 of file job.cpp.

Referenced by KIO::Delete\-Job::slot\-Result().\index{KIO@{KIO}!copy@{copy}}
\index{copy@{copy}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::copy (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a229}


Copy a file or directory {\tt src} into the destination {\tt dest}, which can be a file (including the final filename) or a directory (into which {\tt src} will be copied). 

This emulates the cp command completely.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the file or directory to copy \item[{\em dest}]the destination \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf copy\-As()}{\rm (p.\,\pageref{namespaceKIO_a230})} \end{Desc}


Definition at line 3710 of file job.cpp.

References QValue\-List::append().

Referenced by KFile\-Props\-Plugin::apply\-Changes(), and paste\-Clipboard().\index{KIO@{KIO}!copyAs@{copyAs}}
\index{copyAs@{copyAs}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::copy\-As (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a230}


Copy a file or directory {\tt src} into the destination {\tt dest}, which is the destination name in any case, even for a directory. 

As opposed to {\bf copy()}{\rm (p.\,\pageref{namespaceKIO_a229})}, this doesn't emulate cp, but is the only way to copy a directory, giving it a new name and getting an error box if a directory already exists with the same name.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the file or directory to copy \item[{\em dest}]the destination \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}


Definition at line 3718 of file job.cpp.

References QValue\-List::append().\index{KIO@{KIO}!copy@{copy}}
\index{copy@{copy}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::copy (const {\bf KURL::List} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a231}


Copy a list of file/dirs {\tt src} into a destination directory {\tt dest}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the list of files and/or directories \item[{\em dest}]the destination \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}


Definition at line 3726 of file job.cpp.\index{KIO@{KIO}!move@{move}}
\index{move@{move}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::move (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a232}


Moves a file or directory {\tt src} to the given destination {\tt dest}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the file or directory to copy \item[{\em dest}]the destination \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf copy()}{\rm (p.\,\pageref{namespaceKIO_a229})} 

{\bf move\-As()}{\rm (p.\,\pageref{namespaceKIO_a233})} \end{Desc}


Definition at line 3731 of file job.cpp.

References QValue\-List::append().

Referenced by KFile\-Props\-Plugin::apply\-Changes(), paste\-Clipboard(), and paste\-Data\-Async().\index{KIO@{KIO}!moveAs@{moveAs}}
\index{moveAs@{moveAs}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::move\-As (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a233}


Moves a file or directory {\tt src} to the given destination {\tt dest}. 

Unlike {\bf move()}{\rm (p.\,\pageref{namespaceKIO_a232})} this operation will fail when the directory already exists.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the file or directory to copy \item[{\em dest}]the destination \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf copy\-As()}{\rm (p.\,\pageref{namespaceKIO_a230})} \end{Desc}


Definition at line 3738 of file job.cpp.

References QValue\-List::append().\index{KIO@{KIO}!move@{move}}
\index{move@{move}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::move (const {\bf KURL::List} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a234}


Moves a list of files or directories {\tt src} to the given destination {\tt dest}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the list of files or directories to copy \item[{\em dest}]the destination \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf copy()}{\rm (p.\,\pageref{namespaceKIO_a229})} \end{Desc}


Definition at line 3745 of file job.cpp.\index{KIO@{KIO}!link@{link}}
\index{link@{link}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::link (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest\-Dir}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a235}


Create a link. 

If the protocols and hosts are the same, a Unix symlink will be created. Otherwise, a .desktop file of Type Link and pointing to the src URL will be created.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]The existing file or directory, 'target' of the link. \item[{\em dest\-Dir}]Destination directory where the link will be created. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}


Definition at line 3750 of file job.cpp.

References QValue\-List::append().\index{KIO@{KIO}!link@{link}}
\index{link@{link}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::link (const {\bf KURL::List} \& {\em src}, const {\bf KURL} \& {\em dest\-Dir}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a236}


Create several links If the protocols and hosts are the same, a Unix symlink will be created. 

Otherwise, a .desktop file of Type Link and pointing to the src URL will be created.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]The existing files or directories, 'targets' of the link. \item[{\em dest\-Dir}]Destination directory where the links will be created. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf link()}{\rm (p.\,\pageref{namespaceKIO_a235})} \end{Desc}


Definition at line 3757 of file job.cpp.\index{KIO@{KIO}!linkAs@{linkAs}}
\index{linkAs@{linkAs}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::link\-As (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a237}


Create a link. 

Unlike {\bf link()}{\rm (p.\,\pageref{namespaceKIO_a235})} this operation will fail when the directory already exists. If the protocols and hosts are the same, a Unix symlink will be created. Otherwise, a .desktop file of Type Link and pointing to the src URL will be created.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]The existing file or directory, 'target' of the link. \item[{\em dest}]Destination directory where the link will be created. \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf link}{\rm (p.\,\pageref{namespaceKIO_a235})} () 

{\bf copy\-As()}{\rm (p.\,\pageref{namespaceKIO_a230})} \end{Desc}


Definition at line 3762 of file job.cpp.

References QValue\-List::append().\index{KIO@{KIO}!trash@{trash}}
\index{trash@{trash}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::trash (const {\bf KURL} \& {\em src}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a238}


Trash a file or directory. 

This is currently only supported for local files and directories. Use \char`\"{}KURL src; src.set\-Path( path );\char`\"{} to create a URL from a path.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]file to delete \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 3769 of file job.cpp.

References QValue\-List::append().

Referenced by KDir\-Operator::trash().\index{KIO@{KIO}!trash@{trash}}
\index{trash@{trash}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Copy\-Job} $\ast$ KIO::trash (const {\bf KURL::List} \& {\em src}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a239}


Trash a list of files or directories. 

This is currently only supported for local files and directories.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the files to delete \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}
\begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 3776 of file job.cpp.\index{KIO@{KIO}!del@{del}}
\index{del@{del}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Delete\-Job} $\ast$ KIO::del (const {\bf KURL} \& {\em src}, bool {\em shred} = {\tt false}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a240}


Delete a file or directory. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]file to delete \item[{\em shred}]obsolete (TODO remove in KDE4) \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}


Definition at line 4205 of file job.cpp.

References QValue\-List::append().

Referenced by KDir\-Operator::del(), and KIO::Forwarding\-Slave\-Base::del().\index{KIO@{KIO}!del@{del}}
\index{del@{del}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Delete\-Job} $\ast$ KIO::del (const {\bf KURL::List} \& {\em src}, bool {\em shred} = {\tt false}, bool {\em show\-Progress\-Info} = {\tt true})}\label{namespaceKIO_a241}


Deletes a list of files or directories. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]the files to delete \item[{\em shred}]obsolete (TODO remove in KDE4) \item[{\em show\-Progress\-Info}]true to show progress information \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job handling the operation \end{Desc}


Definition at line 4213 of file job.cpp.\index{KIO@{KIO}!fileMetaInfo@{fileMetaInfo}}
\index{fileMetaInfo@{fileMetaInfo}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf Meta\-Info\-Job} $\ast$ KIO::file\-Meta\-Info (const {\bf KFile\-Item\-List} \& {\em items})}\label{namespaceKIO_a246}


Retrieves meta information for the given items. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]files to get metainfo for \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the {\bf Meta\-Info\-Job}{\rm (p.\,\pageref{classKIO_1_1MetaInfoJob})} to retrieve the items \end{Desc}


Definition at line 172 of file metainfojob.cpp.\index{KIO@{KIO}!fileMetaInfo@{fileMetaInfo}}
\index{fileMetaInfo@{fileMetaInfo}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf Meta\-Info\-Job} $\ast$ KIO::file\-Meta\-Info (const {\bf KURL::List} \& {\em items})}\label{namespaceKIO_a247}


Retrieves meta information for the given items. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]files to get metainfo for \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the {\bf Meta\-Info\-Job}{\rm (p.\,\pageref{classKIO_1_1MetaInfoJob})} to retrieve the items \end{Desc}


Definition at line 177 of file metainfojob.cpp.

References QPtr\-List::append().\index{KIO@{KIO}!pasteClipboard@{pasteClipboard}}
\index{pasteClipboard@{pasteClipboard}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf KIO::Job} $\ast$ KIO::paste\-Clipboard (const {\bf KURL} \& {\em \_\-dest\_\-url}, bool {\em move} = {\tt false})}\label{namespaceKIO_a248}


Pastes the content of the clipboard (e.g. 

URLs) to the given destination URL. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em \_\-dest\_\-url}]the URL to receive the data \item[{\em move}]true to move the data, false to copy \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the job that handles the operation \end{Desc}
\begin{Desc}
\item[See also:]{\bf paste\-Data()}{\rm (p.\,\pageref{namespaceKIO_a249})} \end{Desc}


Definition at line 94 of file paste.cpp.

References QApplication::clipboard(), copy(), QValue\-List::count(), KURLDrag::decode(), KMessage\-Box::error(), move(), paste\-Data\-Async(), KMessage\-Box::sorry(), and QString\-List::split().\index{KIO@{KIO}!pasteData@{pasteData}}
\index{pasteData@{pasteData}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT void KIO::paste\-Data (const {\bf KURL} \& {\em \_\-dest\_\-url}, const {\bf QByte\-Array} \& {\em \_\-data})}\label{namespaceKIO_a249}


Pastes the given {\tt \_\-data} to the given destination URL. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em \_\-dest\_\-url}]the URL to receive the data \item[{\em \_\-data}]the data to copy \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf paste\-Clipboard()}{\rm (p.\,\pageref{namespaceKIO_a248})} \end{Desc}


Definition at line 155 of file paste.cpp.

References KTemp\-File::close(), KTemp\-File::data\-Stream(), KURL::is\-Empty(), KTemp\-File::name(), KTemp\-File::set\-Auto\-Delete(), KIO::Net\-Access$<$ T, K $>$::upload(), and QData\-Stream::write\-Raw\-Bytes().\index{KIO@{KIO}!pasteDataAsync@{pasteDataAsync}}
\index{pasteDataAsync@{pasteDataAsync}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf KIO::Copy\-Job} $\ast$ KIO::paste\-Data\-Async (const {\bf KURL} \& {\em \_\-dest\_\-url}, const {\bf QByte\-Array} \& {\em \_\-data})}\label{namespaceKIO_a250}


Pastes the given {\tt \_\-data} to the given destination URL. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em \_\-dest\_\-url}]the URL to receive the data \item[{\em \_\-data}]the data to copy \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf paste\-Clipboard()}{\rm (p.\,\pageref{namespaceKIO_a248})} \end{Desc}


Definition at line 172 of file paste.cpp.

Referenced by paste\-Clipboard().\index{KIO@{KIO}!pasteDataAsync@{pasteDataAsync}}
\index{pasteDataAsync@{pasteDataAsync}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT {\bf KIO::Copy\-Job} $\ast$ KIO::paste\-Data\-Async (const {\bf KURL} \& {\em \_\-dest\_\-url}, const {\bf QByte\-Array} \& {\em \_\-data}, const {\bf QString} \& {\em text})}\label{namespaceKIO_a251}


Pastes the given {\tt \_\-data} to the given destination URL. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em \_\-dest\_\-url}]the URL to receive the data \item[{\em \_\-data}]the data to copy \item[{\em text}]the text to show in the dialog \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf paste\-Clipboard()}{\rm (p.\,\pageref{namespaceKIO_a248})} \end{Desc}


Definition at line 177 of file paste.cpp.

References KTemp\-File::close(), KTemp\-File::data\-Stream(), KURL::is\-Empty(), move(), KTemp\-File::name(), KURL::set\-Path(), and QData\-Stream::write\-Raw\-Bytes().\index{KIO@{KIO}!isClipboardEmpty@{isClipboardEmpty}}
\index{isClipboardEmpty@{isClipboardEmpty}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIO\_\-EXPORT bool KIO::is\-Clipboard\-Empty ()}\label{namespaceKIO_a252}


Checks whether the clipboard is empty. 

\begin{Desc}
\item[Returns:]true if empty \end{Desc}


Definition at line 78 of file paste.cpp.

References QApplication::clipboard(), QString::contains(), QMime\-Source::encoded\-Data(), and QMime\-Source::provides().\index{KIO@{KIO}!filePreview@{filePreview}}
\index{filePreview@{filePreview}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Preview\-Job} $\ast$ KIO::file\-Preview (const {\bf KFile\-Item\-List} \& {\em items}, int {\em width}, int {\em height} = {\tt 0}, int {\em icon\-Size} = {\tt 0}, int {\em icon\-Alpha} = {\tt 70}, bool {\em scale} = {\tt true}, bool {\em save} = {\tt true}, const {\bf QString\-List} $\ast$ {\em enabled\-Plugins} = {\tt 0})}\label{namespaceKIO_a253}


Creates a {\bf Preview\-Job}{\rm (p.\,\pageref{classKIO_1_1PreviewJob})} to generate or retrieve a preview image for the given URL. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]files to get previews for \item[{\em width}]the maximum width to use \item[{\em height}]the maximum height to use, if this is 0, the same value as width is used. \item[{\em icon\-Size}]the size of the mimetype icon to overlay over the preview or zero to not overlay an icon. This has no effect if the preview plugin that will be used doesn't use icon overlays. \item[{\em icon\-Alpha}]transparency to use for the icon overlay \item[{\em scale}]if the image is to be scaled to the requested size or returned in its original size \item[{\em save}]if the image should be cached for later use \item[{\em enabled\-Plugins}]if non-zero, this points to a list containing the names of the plugins that may be used. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the new {\bf Preview\-Job}{\rm (p.\,\pageref{classKIO_1_1PreviewJob})} \end{Desc}
\begin{Desc}
\item[See also:]{\bf Preview\-Job::available\-Plugins()}{\rm (p.\,\pageref{classKIO_1_1PreviewJob_e0})} \end{Desc}


Definition at line 523 of file previewjob.cpp.

Referenced by KFile\-Icon\-View::show\-Previews().\index{KIO@{KIO}!filePreview@{filePreview}}
\index{filePreview@{filePreview}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Preview\-Job} $\ast$ KIO::file\-Preview (const {\bf KURL::List} \& {\em items}, int {\em width}, int {\em height} = {\tt 0}, int {\em icon\-Size} = {\tt 0}, int {\em icon\-Alpha} = {\tt 70}, bool {\em scale} = {\tt true}, bool {\em save} = {\tt true}, const {\bf QString\-List} $\ast$ {\em enabled\-Plugins} = {\tt 0})}\label{namespaceKIO_a254}


Creates a {\bf Preview\-Job}{\rm (p.\,\pageref{classKIO_1_1PreviewJob})} to generate or retrieve a preview image for the given URL. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]files to get previews for \item[{\em width}]the maximum width to use \item[{\em height}]the maximum height to use, if this is 0, the same value as width is used. \item[{\em icon\-Size}]the size of the mimetype icon to overlay over the preview or zero to not overlay an icon. This has no effect if the preview plugin that will be used doesn't use icon overlays. \item[{\em icon\-Alpha}]transparency to use for the icon overlay \item[{\em scale}]if the image is to be scaled to the requested size or returned in its original size \item[{\em save}]if the image should be cached for later use \item[{\em enabled\-Plugins}]if non-zero, this points to a list containing the names of the plugins that may be used. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the new {\bf Preview\-Job}{\rm (p.\,\pageref{classKIO_1_1PreviewJob})} \end{Desc}
\begin{Desc}
\item[See also:]{\bf Preview\-Job::available\-Plugins()}{\rm (p.\,\pageref{classKIO_1_1PreviewJob_e0})} \end{Desc}


Definition at line 531 of file previewjob.cpp.

References QPtr\-List::append().