wxfsfile

this class represents a single file opened by wxfilesystem. it provides more information than wxwindow's input stream (stream, filename, mime type, anchor).

note: any pointer returned by a method of wxfsfile is valid only as long as the wxfsfile object exists. for example a call to getstream() doesn't create the stream but only returns the pointer to it. in other words after 10 calls to getstream() you will obtain ten identical pointers.

derived from

wxobject

include files

<wx/filesys.h>

see also

wxfilesystemhandler, wxfilesystem, overview

members

wxfsfile::wxfsfile
wxfsfile::detachstream
wxfsfile::getanchor
wxfsfile::getlocation
wxfsfile::getmimetype
wxfsfile::getmodificationtime
wxfsfile::getstream

wxfsfile::wxfsfile

wxfsfile(wxinputstream *stream, const wxstring& loc, const wxstring& mimetype, const wxstring& anchor, wxdatetime modif)

constructor. you probably won't use it. see notes for details.

parameters

stream

the input stream that will be used to access data

location

the full location (aka filename) of the file

mimetype

mime type of this file. mime type is either extension-based or http content-type

anchor

anchor. see getanchor() for details.

if you are not sure of the meaning of these params, see the description of the getxxxx() functions.

notes

it is seldom used by the application programmer but you will need it if you are writing your own virtual fs. for example you may need something similar to wxmemoryinputstream, but because wxmemoryinputstream doesn't free the memory when destroyed and thus passing a memory stream pointer into wxfsfile constructor would lead to memory leaks, you can write your own class derived from wxfsfile:

class wxmyfsfile : public wxfsfile
{
    private:
        void *m_mem;
    public:
        wxmyfsfile(.....)
	~wxmyfsfile() {free(m_mem);}
	    // of course dtor is virtual ;-)
};

wxfsfile::detachstream

void detachstream()

detaches the stream from the wxfsfile object. that is, the stream obtained with getstream() will continue its existance after the wxfsfile object is deleted. you will have to delete the stream yourself.

wxfsfile::getanchor

const wxstring& getanchor() const

returns anchor (if present). the term of anchor can be easily explained using few examples:

index.htm#anchor                      /* 'anchor' is anchor */
index/wx001.htm                       /* no anchor here!    */
archive/main.zip#zip:index.htm#global /* 'global'           */
archive/main.zip#zip:index.htm        /* no anchor here!    */

wxfsfile::getlocation

const wxstring& getlocation() const

returns full location of the file, including path and protocol. examples :

http://www.wxwidgets.org
http://www.ms.mff.cuni.cz/~vsla8348/wxhtml/archive.zip#zip:info.txt
file:/home/vasek/index.htm
relative-file.htm

wxfsfile::getmimetype

const wxstring& getmimetype() const

returns the mime type of the content of this file. it is either extension-based (see wxmimetypesmanager) or extracted from http protocol content-type header.

wxfsfile::getmodificationtime

wxdatetime getmodificationtime() const

returns time when this file was modified.

wxfsfile::getstream

wxinputstream* getstream() const

returns pointer to the stream. you can use the returned stream to directly access data. you may suppose that the stream provide seek and getsize functionality (even in the case of the http protocol which doesn't provide this by default. wxhtml uses local cache to work around this and to speed up the connection).