tarstrm.tex

很牛的GUI源码wxWidgets-2.8.0.zip 可在多种平台下运行.

%
% automatically generated by HelpGen $Revision: 1.2 $ from
% wx/tarstrm.h at 28/Oct/06 18:27:02
%

\section{\class{wxTarClassFactory}}\label{wxtarclassfactory}

Class factory for the tar archive format. See the base class
for details.

\wxheading{Derived from}

\helpref{wxArchiveClassFactory}{wxarchiveclassfactory}

\wxheading{Include files}

<wx/tarstrm.h>

\wxheading{See also}

\helpref{Archive formats such as zip}{wxarc}\\
\helpref{Generic archive programming}{wxarcgeneric}\\
\helpref{wxTarEntry}{wxtarentry}\\
\helpref{wxTarInputStream}{wxtarinputstream}\\
\helpref{wxTarOutputStream}{wxtaroutputstream}


%
% automatically generated by HelpGen $Revision: 1.2 $ from
% wx/tarstrm.h at 28/Oct/06 18:27:02
%

\section{\class{wxTarEntry}}\label{wxtarentry}

Holds the meta-data for an entry in a tar.

\wxheading{Derived from}

\helpref{wxArchiveEntry}{wxarchiveentry}

\wxheading{Include files}

<wx/tarstrm.h>

\wxheading{Data structures}

Constants for \helpref{Get/SetTypeFlag}{wxtarentrytypeflag}:

\begin{verbatim}
// TypeFlag values
enum {
    wxTAR_REGTYPE   = '0',      // regular file
    wxTAR_LNKTYPE   = '1',      // hard link
    wxTAR_SYMTYPE   = '2',      // symbolic link
    wxTAR_CHRTYPE   = '3',      // character special
    wxTAR_BLKTYPE   = '4',      // block special
    wxTAR_DIRTYPE   = '5',      // directory
    wxTAR_FIFOTYPE  = '6',      // named pipe
    wxTAR_CONTTYPE  = '7'       // contiguous file
};

\end{verbatim}

\wxheading{See also}

\helpref{Archive formats such as zip}{wxarc}\\
\helpref{wxTarInputStream}{wxtarinputstream}\\
\helpref{wxTarOutputStream}{wxtaroutputstream}

\wxheading{Field availability}

The tar format stores all the meta-data for an entry ahead of its data,
therefore \helpref{GetNextEntry()}{wxtarinputstreamgetnextentry} always returns
a fully populated wxTarEntry object, both when reading from seekable and
non-seekable streams.


\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxTarEntry::wxTarEntry}\label{wxtarentrywxtarentry}

\func{}{wxTarEntry}{\param{const wxString\& }{name = wxEmptyString}, \param{const wxDateTime\& }{dt = wxDateTime::Now()}, \param{wxFileOffset }{size = wxInvalidOffset}}

Constructor. The tar archive format stores the entry's size ahead of the
entry's data. Therefore when creating an archive on a non-seekable stream it
is necessary to supply the correct size when each entry is created.

\func{}{wxTarEntry}{\param{const wxTarEntry\& }{entry}}

Copy constructor.


\membersection{wxTarEntry::Get/SetAccessTime}\label{wxtarentryaccesstime}

\constfunc{wxDateTime}{GetAccessTime}{\void}

\func{void}{SetAccessTime}{\param{const wxDateTime\& }{dt}}

The entry's access time stamp. See also
 \helpref{wxArchiveEntry::Get/SetDateTime}{wxarchiveentrydatetime}.


\membersection{wxTarEntry::Get/SetCreateTime}\label{wxtarentrycreatetime}

\constfunc{wxDateTime}{GetCreateTime}{\void}

\func{void}{SetCreateTime}{\param{const wxDateTime\& }{dt}}

The entry's creation time stamp. See also
 \helpref{wxArchiveEntry::Get/SetDateTime}{wxarchiveentrydatetime}.


\membersection{wxTarEntry::Get/SetDevMajor and Get/SetDevMinor}\label{wxtarentrydev}

\constfunc{int}{GetDevMajor}{\void}

\constfunc{int}{GetDevMinor}{\void}

\func{void}{SetDevMajor}{\param{int }{dev}}

\func{void}{SetDevMinor}{\param{int }{dev}}

OS specific IDs defining a device, these are only meaningful when
 \helpref{TypeFlag}{wxtarentrytypeflag} is set to {\it wxTAR\_CHRTYPE}
 or {\it wxTAR\_BLKTYPE}.


\membersection{wxTarEntry::Get/SetGroupId and Get/SetUserId}\label{wxtarentryuidgid}

\constfunc{int}{GetGroupId}{\void}

\constfunc{int}{GetUserId}{\void}

\func{void}{SetGroupId}{\param{int }{id}}

\func{void}{SetUserId}{\param{int }{id}}

The user ID and group ID that has \helpref{permissions}{wxtarentrymode} over
this entry. These values aren't usually useful unless the file will only be
restored to the same system it originated from. \helpref{Get/SetGroupName and
Get/SetUserName}{wxtarentryunamegname} can be used instead.


\membersection{wxTarEntry::Get/SetGroupName and Get/SetUserName}\label{wxtarentryunamegname}

\constfunc{wxString}{GetGroupName}{\void}

\constfunc{wxString}{GetUserName}{\void}

\func{void}{SetGroupName}{\param{const wxString\& }{group}}

\func{void}{SetUserName}{\param{const wxString\& }{user}}

The names of the user and group that has \helpref{permissions}{wxtarentrymode}
over this entry. These are not present in very old tars.


\membersection{wxTarEntry::GetInternalName}\label{wxtarentrygetinternalname}

\constfunc{wxString}{GetInternalName}{\void}

Returns the entry's filename in the internal format used within the
archive. The name can include directory components, i.e. it can be a
full path.

The names of directory entries are returned without any trailing path
separator. This gives a canonical name that can be used in comparisons.

\func{wxString}{GetInternalName}{\param{const wxString\& }{name}, \param{wxPathFormat }{format = wxPATH\_NATIVE}, \param{bool* }{pIsDir = NULL}}

A static member that translates a filename into the internal format used
within the archive. If the third parameter is provided, the bool pointed
to is set to indicate whether the name looks like a directory name
(i.e. has a trailing path separator).


\membersection{wxTarEntry::Get/SetLinkName}\label{wxtarentrylinkname}

\constfunc{wxString}{GetLinkName}{\void}

\func{void}{SetLinkName}{\param{const wxString\& }{link}}

The filename of a previous entry in the tar that this entry is a link to.
Only meaningful when \helpref{TypeFlag}{wxtarentrytypeflag} is set
to {\it wxTAR\_LNKTYPE} or {\it wxTAR\_SYMTYPE}.


\membersection{wxTarEntry::Get/SetMode}\label{wxtarentrymode}

\constfunc{int}{GetMode}{\void}

\func{void}{SetMode}{\param{int }{mode}}

UNIX permission bits for this entry. Giving read, write and execute permissions
to the file's \helpref{User and Group}{wxtarentryunamegname} and to others.
Symbols are defined for them in <wx/file.h>.

\begin{verbatim}
#define wxS_IRUSR 00400
#define wxS_IWUSR 00200
#define wxS_IXUSR 00100

#define wxS_IRGRP 00040
#define wxS_IWGRP 00020
#define wxS_IXGRP 00010

#define wxS_IROTH 00004
#define wxS_IWOTH 00002
#define wxS_IXOTH 00001

\end{verbatim}


\membersection{wxTarEntry::Get/SetSize}\label{wxtarentrysize}

\func{void}{SetSize}{\param{wxFileOffset }{size}}

\constfunc{wxFileOffset}{GetSize}{\void}

The size of the entry's data in bytes.

The tar archive format stores the entry's size ahead of the entry's data.
Therefore when creating an archive on a non-seekable stream it is necessary to
supply the correct size when each entry is created. For seekable streams this
is not necessary as \helpref{wxTarOutputStream}{wxtaroutputstream} will attempt
to seek back and fix the entry's header when the entry is closed, though it is
still more efficient if the size is given beforehand.


\membersection{wxTarEntry::Get/SetTypeFlag}\label{wxtarentrytypeflag}

\constfunc{int}{GetTypeFlag}{\void}

\func{void}{SetTypeFlag}{\param{int }{type}}

Returns the type of the entry. It should be one of the following:

\begin{verbatim}
// TypeFlag values
enum {
    wxTAR_REGTYPE   = '0',      // regular file
    wxTAR_LNKTYPE   = '1',      // hard link
    wxTAR_SYMTYPE   = '2',      // symbolic link
    wxTAR_CHRTYPE   = '3',      // character special
    wxTAR_BLKTYPE   = '4',      // block special
    wxTAR_DIRTYPE   = '5',      // directory
    wxTAR_FIFOTYPE  = '6',      // named pipe
    wxTAR_CONTTYPE  = '7'       // contiguous file
};

\end{verbatim}

When creating archives use just these values. When reading archives
any other values should be treated as {\it wxTAR\_REGTYPE}.