/usr/include/paragui/pgfile.h is in libparagui1.1-dev 1.1.8-3.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 | /*
ParaGUI - crossplatform widgetset
Copyright (C) 2000,2001,2002 Alexander Pipelka
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Alexander Pipelka
pipelka@teleweb.at
Last Update: $Author: braindead $
Update Date: $Date: 2004/03/12 18:46:38 $
Source File: $Source: /cvsroot/paragui/paragui/include/pgfile.h,v $
CVS/RCS Revision: $Revision: 1.3.6.4.2.3 $
Status: $State: Exp $
*/
/** \file pgfile.h
Header file of the PG_File class.
*/
#ifndef PG_FILE_H
#define PG_FILE_H
#include "paragui.h"
#include <string>
// strange hack needed for GCC 2.91 - Alex
#ifdef getc
#undef getc
#endif
/**
* @author Alexander Pipelka
*
* @short file abstraction for the PhsicsFS (used in conjunction with PG_FileArchive)
*/
class DECLSPEC PG_File {
protected:
/**
The constructor can only be called from PG_FileArchive or any subclass.
PG_File object are create by PG_FileArchive::OpenFile(...)
@param f pointer to PhysicsFS file
*/
PG_File(void* f);
public:
~PG_File();
// lowlevel physfs functions
/**
read bytes from the stream
@param buffer buffer to fill
@param bytestoread number of bytes to read from the stream
@return number of bytes read
*/
int read(void *buffer, unsigned int bytestoread);
/**
write bytes to the stream
@param buffer buffer to write
@param bytestowrite number of bytes to write to the stream
@return number of bytes written
*/
int write(void *buffer, unsigned int bytestowrite);
//! write bytes to the stream
/*!
\param buffer buffer to write
\return number of bytes written
*/
int write(std::string &buffer);
//! write bytes to the stream
/*!
\param buffer buffer to write
\return number of bytes written
*/
int write(const char *buffer);
/**
read records from the stream
@param buffer buffer to fill
@param objSize size (in bytes) of a record
@param objCount number of records to read
@return number of records read
*/
int read(void *buffer, unsigned int objSize, unsigned int objCount);
/**
write records to the stream
@param buffer buffer to write
@param objSize size (in bytes) of a record
@param objCount number of records to write
@return number of records written
*/
int write(void *buffer, unsigned int objSize, unsigned int objCount);
/**
check for the end of the file.
@return true if we touched the end of the file.
*/
bool eof();
/**
get the current position in the file stream
@return current file stream position
*/
int tell();
/**
set the file pointer to a given position
@param pos position to set
@return true on success
*/
bool seek(int pos);
/**
return the length of the file (in bytes)
@return length of the file
*/
int fileLength();
/**
get a single character from the file
*/
char getc();
/**
read a line from the file.
This function reads a CR/LF terminated line of text from the file.
Any trailing carriage return and linefeed characters will be skipped.
*/
std::string getline();
/**
write a line to the file
@param line text to write
This functions writes a line of text to a file. Carriage return (and linefeed)
characters will be added.
*/
void putline(const std::string& line);
private:
void* file;
friend class PG_FileArchive;
};
#endif
|