ppl7::File Klassenreferenz

Dateizugriff. Mehr ...

Abgeleitet von ppl7::FileObject.

Öffentliche Typen
enum	FileMode { READ =1, WRITE, READWRITE, APPEND }
	Zugriffsmodus beim Öffnen einer Datei. Mehr ...
enum	SeekOrigin { SEEKCUR =1, SEEKEND, SEEKSET }
	Ausgangsbasis für Bewegung des Dateizeigers. Mehr ...

Öffentliche Methoden
	File ()
	Konstruktor der Klasse. Mehr ...
	File (const String &filename, FileMode mode=READ)
	Konstruktor der Klasse mit gleichzeitigem Öffnen einer Datei. Mehr ...
	File (FILE *handle)
	Konstruktor mit Übernahme eines C-Filehandles. Mehr ...
virtual	~File ()
	Destruktor der Klasse. Mehr ...
virtual void	close ()
	Datei schließen. Mehr ...
ppluint64	copyFrom (FileObject &quellfile, ppluint64 quelloffset, ppluint64 bytes, ppluint64 zieloffset)
	Daten aus einer anderen Datei kopieren. Mehr ...
ppluint64	copyFrom (FileObject &quellfile, ppluint64 bytes)
	Daten aus einer anderen Datei kopieren. Mehr ...
virtual bool	eof () const
	Prüfen, ob Dateiende erreicht ist. Mehr ...
void	erase ()
	Geöffnete Datei löschen. Mehr ...
virtual int	fgetc ()
	Zeichen lesen. Mehr ...
virtual char *	fgets (char *buffer, size_t num)
	String lesen. Mehr ...
virtual wchar_t	fgetwc ()
	Wide-Character Zeichen lesen. Mehr ...
virtual wchar_t *	fgetws (wchar_t *buffer, size_t num=1024)
	Wide-Character String lesen. Mehr ...
const String &	filename () const
	Dateiname auslesen. Mehr ...
virtual void	flush ()
	Gepufferte Daten schreiben. Mehr ...
virtual void	fputc (int c)
	Zeichen schreiben. Mehr ...
virtual void	fputs (const char *str)
	String schreiben. Mehr ...
virtual void	fputwc (wchar_t c)
	Wide-Character Zeichen schreiben. Mehr ...
virtual void	fputws (const wchar_t *str)
	Wide-Character String schreiben. Mehr ...
virtual size_t	fread (void *ptr, size_t size, size_t nmemb)
	Lesen eines Datenstroms. Mehr ...
virtual size_t	fwrite (const void *ptr, size_t size, size_t nmemb)
	Schreiben eines Datenstroms. Mehr ...
virtual int	getFileNo () const
	Filenummer der Datei. Mehr ...
int	gets (String &buffer, size_t num=1024)
	String lesen. Mehr ...
String	gets (size_t num=1024)
	String lesen. Mehr ...
int	getws (String &buffer, size_t num=1024)
	Wide-Character String lesen. Mehr ...
String	getws (size_t num=1024)
	Wide-Character String lesen. Mehr ...
virtual bool	isOpen () const
	Prüfen, ob eine Datei geöffnet ist. Mehr ...
char *	load ()
	Den kompletten Inhalt der Datei laden. Mehr ...
int	load (ByteArray &target)
	Den kompletten Inhalt der Datei in ein Objekt laden. Mehr ...
virtual void	lockExclusive (bool block=true)
	Datei exklusiv sperren. Mehr ...
virtual void	lockShared (bool block=true)
	Datei zum Lesen sperren. Mehr ...
const char *	map ()
	Datei in den Speicher mappen. Mehr ...
virtual const char *	map (ppluint64 position, size_t size)
	Datei Read-Only in den Speicher mappen. Mehr ...
virtual char *	mapRW (ppluint64 position, size_t size)
	Datei Les- und Schreibbar in den Speicher mappen. Mehr ...
String	md5 ()
void	open (const String &filename, FileMode mode=READ)
	Datei öffnen. Mehr ...
void	open (const char *filename, FileMode mode=READ)
	Datei zum Lesen oder Schreiben öffnen. Mehr ...
void	open (FILE *handle)
	Bereits geöffnete Datei übernehmen. Mehr ...
void	openTemp (const String &filetemplate)
	Eine temporäre Datei zum Lesen und Schreiben öffnen. Mehr ...
void	openTemp (const char *filetemplate)
	Eine temporäre Datei zum Lesen und Schreiben öffnen. Mehr ...
void	popen (const char *command, FileMode mode=READ)
	Prozess öffnen. Mehr ...
void	popen (const String &command, FileMode mode=READ)
	Prozess öffnen. Mehr ...
	PPL7EXCEPTION (IllegalFilemodeException, Exception)
void	puts (const String &str)
	String schreiben. Mehr ...
void	putsf (const char *fmt,...)
	Formatierten String schreiben. Mehr ...
void	putws (const WideString &str)
	Wide-Character-String schreiben. Mehr ...
size_t	read (void *target, size_t bytes, ppluint64 fileposition)
	Daten lesen. Mehr ...
size_t	read (void *target, size_t bytes)
	Daten lesen. Mehr ...
size_t	read (ByteArray &target, size_t bytes)
	Daten in ein Objekt einlesen. Mehr ...
virtual void	rewind ()
	Dateizeiger an den Anfang der Datei bringen. Mehr ...
virtual void	seek (ppluint64 position)
	Dateizeiger auf gewünschte Stelle bringen. Mehr ...
virtual ppluint64	seek (pplint64 offset, SeekOrigin origin)
	Dateizeiger auf gewünschte Stelle bringen. Mehr ...
void	setFilename (const char *filename)
	Dateiname festlegen. Mehr ...
void	setFilename (const String &filename)
	Dateiname festlegen. Mehr ...
virtual void	setMapReadAhead (size_t bytes)
	Minimalgröße des Speicherblocks bei Zugriffen mit FileObject::Map. Mehr ...
virtual ppluint64	size () const
	Größe der geöffneten Datei. Mehr ...
virtual void	sync ()
	Dateiänderungen sofort auf die Platte schreiben. Mehr ...
virtual ppluint64	tell ()
	Aktuelle Dateiposition ermitteln. Mehr ...
virtual void	truncate (ppluint64 length)
	Datei abschneiden. Mehr ...
virtual void	unlock ()
	Dateisperre aufheben. Mehr ...
virtual void	unmap ()
	Mapping aufheben. Mehr ...
size_t	write (const void *source, size_t bytes, ppluint64 fileposition)
	Daten schreiben. Mehr ...
size_t	write (const void *source, size_t bytes)
	Daten schreiben. Mehr ...
size_t	write (const ByteArrayPtr &object, size_t bytes=0)
	Daten eines von Variant abgeleiteten Objekts schreiben. Mehr ...

Öffentliche, statische Methoden
static void	chmod (const String &filename, FileAttr::Attributes attr)
	Setz die Attribute einer exisitierenden Datei. Mehr ...
static void	copy (const String &oldfile, const String &newfile)
	Datei kopieren. Mehr ...
static void	erase (const String &filename)
	Datei löschen. Mehr ...
static bool	exists (const String &filename)
	Prüfen, ob eine Datei existiert. Mehr ...
static const char *	fmode (FileMode mode)
	C-Filemode-String. Mehr ...
static const char *	fmodepopen (FileMode mode)
	C-Filemode-String für popen. Mehr ...
static String	getFilename (const String &path)
	Dateinamen ohne Pfad. Mehr ...
static String	getPath (const String &path)
	Pfad ohne Dateinamen. Mehr ...
static void	load (ByteArray &object, const String &filename)
	Datei in ein ByteArray laden. Mehr ...
static void	load (String &object, const String &filename)
	Datei in einen String laden. Mehr ...
static void *	load (const String &filename, size_t *size=NULL)
	Kompletten Inhalt einer Datei laden. Mehr ...
static String	md5Hash (const String &filename)
static void	move (const String &oldfile, const String &newfile)
	Datei verschieben oder umbenennen. Mehr ...
static void	remove (const String &filename)
	Geöffnete Datei löschen. Mehr ...
static void	rename (const String &oldfile, const String &newfile)
	Datei verschieben oder umbenennen. Mehr ...
static void	save (const void *content, size_t size, const String &filename)
	Daten in Datei schreiben. Mehr ...
static void	save (const ByteArrayPtr &object, const String &filename)
	Daten eines von ByteArrayPtr Objekts in Datei schreiben. Mehr ...
static void	statFile (const String &filename, DirEntry &result)
	Informationen zu einer Datei oder Verzeichnis. Mehr ...
static DirEntry	statFile (const String &filename)
static void	throwErrno (int e, const String &filename)
	Exception anhand errno-Variable werfen Mehr ...
static void	touch (const String &filename)
	Leere Datei anlegen oder die Zeitstempel des letzten Zugriffs aktualisieren. Mehr ...
static void	truncate (const String &filename, ppluint64 bytes)
	Datei abschneiden. Mehr ...
static void	unlink (const String &filename)
	Geöffnete Datei löschen. Mehr ...

Geschützte Attribute
char *	buffer

Private Methoden
void *	mmap (ppluint64 position, size_t size, int prot, int flags)
int	munmap (void *addr, size_t len)
void	throwErrno (int e)
	Exception anhand errno-Variable werfen. Mehr ...

Private Attribute
void *	ff
bool	isPopen
int	LastMapProtection
ppluint64	LastMapSize
ppluint64	LastMapStart
char *	MapBase
ppluint64	mysize
ppluint64	pos
ppluint64	ReadAhead

Ausführliche Beschreibung

Include:

#include <ppl7.h>

Beschreibung:

Mit dieser Klasse können Dateien geladen, verändert und gespeichert werden. Sie dient als Wrapper-Klasse für die Low-Level Funktionen des Betriebssystems.

Dokumentation der Aufzählungstypen

enum ppl7::File::FileMode

Beschreibung:

Zugriffsmodus beim Öffnen einer Datei mit File::open

Aufzählungswerte
READ	Datei zum Lesen öffnen, Zeiger wird an den Anfang der Datei gesetzt.
WRITE	Datei zum Schreiben öffnen. Falls die Datei schon vorhanden ist, wird sie gelöscht.
READWRITE	Datei zum Lesen und Schreiben öffnen. Zeiger wird an den Anfang der Datei positioniert.
APPEND	Datei zum Schreiben öffnen, Zeiger wird ans Ende der Datei positioniert.

enum ppl7::FileObject::SeekOrigin

inherited

Beschreibung:

Diese Enumeration definiert die Ausgahgsbasis für Bewegungen des Dateizeigers miitels der Funktion FileObject::seek

Aufzählungswerte
SEEKCUR	Ausgehend von der aktuellen Position des Dateizeigers.
SEEKEND	Ausgehend vom Ende der Datei.
SEEKSET	Ausgehend vom Anfang der Datei.

Beschreibung der Konstruktoren und Destruktoren

ppl7::File::File

(

)

Beschreibung:

Konstruktor der Klasse

ppl7::File::File	(	const String &	filename,
		FileMode	mode = READ
	)

Konstruktor der Klasse, mit dem gleichzeitig eine Datei geöffnet wird.

Parameter

[in]	filename	Name der zu öffnenden Datei
[in]	mode	Zugriffsmodus. Defaultmäßig wird die Datei zum binären Lesen geöffnet (siehe ppl7_File_Filemodi)

ppl7::File::File

(

FILE *

handle

)

Beschreibung:

Konstruktor der Klasse mit Übernahme eines C-Filehandles einer bereits mit ::fopen geöffneten Datei.

Parameter

[in]

handle

File-Handle

ppl7::File::~File ( )

virtual

Beschreibung:

Der Destruktor der Klasse sorgt dafür, dass eine noch geöffnete Datei geschlossen wird und alle Systemresourcen wieder freigegeben werden.

Dokumentation der Elementfunktionen

void ppl7::File::close ( )

virtual

Beschreibung:

Diese Funktion schließt die aktuell geöffnete Datei. Sie wird automatisch vom Destruktor der Klasse aufgerufen, so dass ihr expliziter Aufruf nicht erforderlich ist.

Wenn der Stream zur Ausgabe eingerichtet war, werden gepufferte Daten zuerst durch FileObject::flush geschrieben. Der zugeordnete Datei-Deskriptor wird geschlossen, alle Systemressourcen werden freigegeben.

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

Erneute Implementation von ppl7::FileObject.

ppluint64 ppl7::FileObject::copyFrom ( FileObject &  quellfile, ppluint64  quelloffset, ppluint64  bytes, ppluint64  zieloffset  )

inherited

Beschreibung:

Mit dieser Funktion kann ein Datenblock aus einer anderen Datei in diese hineinkopiert werden. Dabei werden bytes Bytes ab der Position quelloffset der Quelldatei quellfile gelesen an die Position zieloffset dieser Datei kopiert.

Parameter

quellfile	Das Dateiobjekt, aus dem gelesen werden soll
quelloffset	Position innerhalb der Quelldatei, ab der die Daten gelesen werden sollen
bytes	Anzahl zu kopierender Bytes
zieloffset	Position in dieser Datei, an die die Daten geschrieben werden sollen

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl kopierter Bytes zurück. Im Fehlerfall wird eine Exception geworfen.

Zu beachten

Die Funktion verwendet einen internen Buffer zum Zwischenspeichern der gelesenen Daten.

ppluint64 ppl7::FileObject::copyFrom ( FileObject &  quellfile, ppluint64  bytes  )

inherited

Beschreibung:

Mit dieser Funktion kann ein Datenblock aus einer anderen Datei in diese hineinkopiert werden. Die Daten werden dabei ab dem aktuellen Dateipositionszeiger des quellfile an den aktuellen Zeiger dieser Datei kopiert.

Parameter

quellfile	Das Dateiobjekt, aus dem gelesen werden soll
bytes	Anzahl zu kopierender Bytes

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl kopierter Bytes zurück. Im Fehlerfall wird eine Exception geworfen.

Zu beachten

Die Funktion verwendet einen internen Buffer zum Zwischenspeichern der gelesenen Daten.

bool ppl7::File::eof ( ) const

virtual

Beschreibung:

Die Funktion prüft, ob das Dateiende erreicht wurde

Rückgabe

Liefert true zurück, wenn das Dateiende erreicht wurde, sonst false Falls die Datei nicht geöffnet war, wird wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

void ppl7::File::erase

(

)

Beschreibung:

Mit dieser Funktion wird die aktuelle Datei zunächst geschlossen und dann gelöscht.

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

int ppl7::File::fgetc ( )

virtual

Beschreibung:

fgetc liest das nächste Zeichen aus der Datei und gibt seinen unsigned char Wert gecastet in einem int zurück.

Rückgabe

Bei Erfolg wird der Wert des gelesenen Zeichens zurückgegeben, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

char * ppl7::File::fgets ( char *  buffer, size_t  num  )

virtual

Beschreibung:

fgets liest höchstens num minus ein Zeichen aus der Datei und speichert sie in dem Puffer, auf den buffer zeigt. Das Lesen stoppt nach einem EOF oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem Puffer gespeichert. Am Ende der gelesenen Daten wird ein 0-Byte angehangen.

Parameter

buffer	Pointer auf den Speicherbereich, in den die gelesenen Daten geschrieben werden sollen. Dieser muss vorher vom Aufrufer allokiert worden sein und mindestens num Bytes groß sein.
num	Anzahl zu lesender Zeichen

Rückgabe

Bei Erfolg wird buffer zurückgegeben, bei Dateiende wird NULL zurückgegeben. Im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

wchar_t ppl7::File::fgetwc ( )

virtual

Beschreibung:

fgetwc liest das nächste Wide-Character Zeichen aus der Datei und gibt seinen Wert als Integer zurück.

Rückgabe

Bei Erfolg wird das gelesene Zeichen als Integer Wert zurückgegeben, im Fehlerfall wird eine Exception geworfen.

Zu beachten

Die Funktion ist unter Umständen nicht auf jedem Betriebssystem verfügbar.

Erneute Implementation von ppl7::FileObject.

wchar_t * ppl7::File::fgetws ( wchar_t *  buffer, size_t  num = 1024  )

virtual

Beschreibung:

fgwets liest höchstens num minus ein Zeichen (nicht Bytes) eines Wide-Character-Strings aus der Datei und speichert sie in dem Puffer, auf den buffer zeigt. Das Lesen stoppt nach einem EOF oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem Puffer gespeichert. Am Ende der gelesenen Daten wird ein 0-Byte angehangen.

Parameter

buffer	Pointer auf den Speicherbereich, in den die gelesenen Daten geschrieben werden sollen. Dieser muss vorher vom Aufrufer allokiert worden sein und mindestens num * sizeof(wchar_t) Bytes groß sein.
num	Anzahl zu lesender Zeichen

Rückgabe

Bei Erfolg wird buffer zurückgegeben, bei Dateiende wird NULL zurückgegeben. Im Fehlerfall wird eine Exception geworfen.

Zu beachten

Die Funktion ist unter Umständen nicht auf jedem Betriebssystem verfügbar. In diesem Fall wird eine

Ausnahmebehandlung

UnimplementedVirtualFunctionException

geworfen.

Erneute Implementation von ppl7::FileObject.

const String & ppl7::FileObject::filename ( ) const

inherited

Include:

#include <ppl7.h>

Beschreibung:

Mit dieser Funktion wird der interne Dateiname ausgelesen. Dieser wird über die Open-Funktionen oder die Funktion SetFilename festgelegt.

Rückgabe

Die Funktion liefert entweder den Dateinamen zurück oder "unknown"

void ppl7::File::flush ( )

virtual

Beschreibung:

Die Funktion Flush bewirkt, dass alle gepufferten Daten des aktuellen Streams mittels der zugrundeliegenden write-Funktion geschrieben werden. Der Status des Streams wird dabei nicht berührt. Die Daten werden nicht zwangsweise auch physikalisch auf die Platte geschrieben, sie können noch immer aus Performancegründen vom Kernel oder Treiber gecached werden. Um 100 Prozent sicher zu gehen, kann man die Funktion FileObject::sync verwenden.

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

const char * ppl7::File::fmode ( FileMode  mode )

static

Beschreibung:

Diese interne Funktion gibt den zum Datemodus mode passenden C-Filemode-String zurück.

Parameter

mode	Filemodus aus der Enumeration FileMode

Rückgabe

C-String

const char * ppl7::File::fmodepopen ( FileMode  mode )

static

Beschreibung:

Diese interne Funktion gibt den zum Datemodus mode passenden C-Filemode-String für die popen-Funktion zurück.

Parameter

mode	Filemodus aus der Enumeration FileMode

Rückgabe

C-String

void ppl7::File::fputc ( int  c )

virtual

Beschreibung:

fputc schreibt das Zeichen c, umgesetzt in ein unsigned char, in den Ausgabestrom.

Parameter

c	Zu schreibendes Zeichen

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

void ppl7::File::fputs ( const char *  str )

virtual

Beschreibung:

fputs schreibt die Zeichenkette str ohne sein nachfolgendes 0-Byte in den Ausgabestrom.

Parameter

str	Pointer auf den zu schreibenden String

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

void ppl7::File::fputwc ( wchar_t  c )

virtual

Beschreibung:

fputwc schreibt das Wide-Character Zeichen c in den Ausgabestrom.

Parameter

c	Zu schreibendes Zeichen

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Zu beachten

Die Funktion ist unter Umständen nicht auf jedem Betriebssystem verfügbar.

Erneute Implementation von ppl7::FileObject.

void ppl7::File::fputws ( const wchar_t *  str )

virtual

Beschreibung:

fputs schreibt die Zeichenkette str ohne sein nachfolgendes 0-Byte in den Ausgabestrom.

Parameter

str	Pointer auf den zu schreibenden String

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Zu beachten

Die Funktion ist unter Umständen nicht auf jedem Betriebssystem verfügbar. In diesem Fall wird Fehlercode 246 zurückgegeben.

Erneute Implementation von ppl7::FileObject.

size_t ppl7::File::fread ( void *  ptr, size_t  size, size_t  nmemb  )

virtual

Beschreibung:

Die Funktion fread liest nmemb Datenelemente vom Dateistrom und speichert es an der Speicherposition, die durch ptr bestimmt ist. Jedes davon ist \ size Byte lang.

Parameter

[out]	ptr	Pointer auf den Speicherbereich, in den die gelesenen Daten abgelegt werden sollen. Der Aufrufer muss vorher mindestens size * nmemb Bytes Speicher reserviert haben.
[in]	size	Größe der zu lesenden Datenelemente
[in]	nmemb	Anzahl zu lesender Datenelemente

Rückgabe

fread gibt die Anzahl der erfolgreich gelesenen Elemente zurück (nicht die Anzahl der Zeichen). Wenn ein Fehler auftritt oder das Dateiende erreicht ist, wird eine Exception geworfen.

Ausnahmebehandlung

EndOfFileException

Wird geworfen, wenn das Dateiende erreicht wurde

Erneute Implementation von ppl7::FileObject.

size_t ppl7::File::fwrite ( const void *  ptr, size_t  size, size_t  nmemb  )

virtual

Beschreibung:

Die Funktion fwrite schreibt nmemb Datenelemente der Größe size Bytes, in den Dateistrom. Sie werden von der Speicherstelle, die durch ptr angegeben ist, gelesen.

Parameter

ptr	Pointer auf den Beginn des zu schreibenden Speicherbereiches.
size	Größe der zu schreibenden Datenelemente
nmemb	Anzahl zu schreibender Datenelemente

Rückgabe

fwrite gibt die Anzahl der erfolgreich geschriebenen Elemente zurück (nicht die Anzahl der Zeichen). Wenn ein Fehler auftritt, wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

String ppl7::File::getFilename ( const String &  path )

static

Beschreibung:

Diese Funktion liefert den Dateinamen eines Strings zurück, der Pfad und Dateinamen enthält. Lautet der String beispielsweise "/home/patrick/svn/ppl7/README.TXT" liefert die Funktion "README.TXT" zurück.

Parameter

path	Pfad mit Dateinamen

Rückgabe

String mit dem Dateinamen

int ppl7::File::getFileNo ( ) const

virtual

Beschreibung:

Die Funktion liefert den Dateideskriptor als Integer zurück, wie er von den Systemfunktionen open , read , write und close genutzt wird.

Rückgabe

Liefert die Filenummer zurück oder wirft eine Exception, wenn die Datei nicht geöffnet war.

Erneute Implementation von ppl7::FileObject.

String ppl7::File::getPath ( const String &  path )

static

Beschreibung:

Diese Funktion liefert den Verzeichnisnamen eines Strings zurück, der Pfad und Dateinamen enthält. Lautet der String beispielsweise "/home/patrick/svn/ppl7/README.TXT" liefert die Funktion "/home/patrick/svn/ppl7/" zurück.

Parameter

path	Pfad mit Dateinamen

Rückgabe

String mit dem Pfad

int ppl7::FileObject::gets ( String &  buffer, size_t  num = 1024  )

inherited

Beschreibung:

Gets liest höchstens num minus ein Zeichen aus der Datei und speichert sie im String-Objekt buffer. Das Lesen stoppt nach einem EOF oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem Puffer gespeichert. Am Ende der gelesenen Daten wird ein 0-Byte angehangen.

Parameter

buffer	String-Objekt, in dem die gelesenen Daten gespeichert werden sollen.
num	Anzahl zu lesender Zeichen

Rückgabe

Bei Erfolg wird 1 zurückgegeben, bei Erreichen des Dateiende 0. Im Fehlerfall wird eine Exception geworfen. Der Inhalt von buffer ist im Fehlerfall undefiniert.

String ppl7::FileObject::gets ( size_t  num = 1024 )

inherited

Beschreibung:

Gets liest höchstens num minus ein Zeichen aus der Datei und liefert deren Inhalt als String-Objekt zurück. Das Lesen stoppt nach einem EOF oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem Puffer gespeichert. Am Ende der gelesenen Daten wird ein 0-Byte angehangen.

Parameter

num	Anzahl zu lesender Zeichen

Rückgabe

Die Funktion gibt ein String-Objekt mit den gelesenen Daten zurück. Im Fehlerfall (auch bei Dateiende) wird eine Exception geworfen.

int ppl7::FileObject::getws ( String &  buffer, size_t  num = 1024  )

inherited

Beschreibung:

Gets liest höchstens num minus ein Zeichen aus der Datei und speichert sie im Wide-Character-String-Objekt buffer. Das Lesen stoppt nach einem WEOF oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem Puffer gespeichert. Am Ende der gelesenen Daten wird ein 0-Byte angehangen.

Parameter

buffer	Wide-Character-String-Objekt, in dem die gelesenen Daten gespeichert werden sollen.
num	Anzahl zu lesender Zeichen. Hierbei handelt es sich tatsächlich um Zeichen, nicht um Bytes. Die Anzahl zu lesender Bytes wird intern mit der Formel num * sizeof(wchar_t) errechnet.

Rückgabe

Bei Erfolg wird 1 zurückgegeben, bei Erreichen des Dateiende 0. Im Fehlerfall wird eine Exception geworfen. Der Inhalt von buffer ist im Fehlerfall undefiniert.

String ppl7::FileObject::getws ( size_t  num = 1024 )

inherited

Beschreibung:

Gets liest höchstens num minus ein Zeichen aus der Datei liefert sie als Wide-Character-String-Objekt zurück. Das Lesen stoppt nach einem WEOF oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem Puffer gespeichert. Am Ende der gelesenen Daten wird ein 0-Byte angehangen.

Parameter

num	Anzahl zu lesender Zeichen. Hierbei handelt es sich tatsächlich um Zeichen, nicht um Bytes. Die Anzahl zu lesender Bytes wird intern mit der Formel num * sizeof(wchar_t) errechnet.

Rückgabe

Die Funktion gibt ein String-Objekt mit den gelesenen Daten zurück. Im Fehlerfall (auch bei Dateiende) wird eine Exception geworfen.

bool ppl7::File::isOpen ( ) const

virtual

Include:

#include <ppl7.h>

Beschreibung:

Mit dieser Funktion kann geprüft werden, ob die mit diesem Objekt assoziierte Datei gerade geöffnet ist.

Rückgabe

Die Funktion liefert true zurück, wenn die Datei offen ist, ansonsten false.

Erneute Implementation von ppl7::FileObject.

char * ppl7::FileObject::load ( )

inherited

Beschreibung:

Mit dieser Funktion wird der komplette Inhalt der geöffneten Datei in den Hauptspeicher geladen. Der benötigte Speicher wird von der Funktion automatisch allokiert und muss vom Aufrufer nach Gebrauch mit free wieder freigegeben werden.

Rückgabe

Pointer auf den Speicherbereich mit dem Inhalt der Datei. Dieser muss vom Aufrufer nach Gebrauch mit free selbst wieder freigegeben werden. Im Fehlerfall wird eine Exception geworfen.

int ppl7::FileObject::load ( ByteArray &  object )

inherited

Beschreibung:

Mit dieser Funktion wird der komplette Inhalt der geöffneten Datei in das angegebene ByteArray object geladen.

Parameter

[out]

object

Das gewünschte Zielobjekt

Rückgabe

Liefert 1 zurück, wenn der Inhalt geladen werden konnte, sonst 0.

void ppl7::File::lockExclusive ( bool  block = true )

virtual

Beschreibung:

Mit LockExclusive wird die Datei exklusiv zum Schreiben gesperrt. Andere Prozesse können nicht auf die Datei zugreifen, solange die Sperre besteht.

Parameter

block

Gibt an, ob die Funktion warten soll (blocken), bis die Datei gesperrt werden kann (block=true) oder sofort mit einer Fehlermeldung zurückkehren soll (block=false).

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Siehe auch

Siehe auch File::LockShared und File::Unlock

Erneute Implementation von ppl7::FileObject.

void ppl7::File::lockShared ( bool  block = true )

virtual

Beschreibung:

Mit LockShared wird die Datei zum Lesen gesperrt. Andere Prozesse können weiterhin auf die Datei zugreifen, allerdings ebenfalls nur lesend.

Parameter

block

Gibt an, ob die Funktion warten soll (blocken), bis die Datei gesperrt werden kann (block=true) oder sofort mit einer Fehlermeldung zurückkehren soll (block=false).

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Siehe auch

Siehe auch File::LockExclusive und File::Unlock

Erneute Implementation von ppl7::FileObject.

const char * ppl7::FileObject::map ( )

inherited

Beschreibung:

Mit dieser Funktion wird der komplette Inhalt der Datei in den Speicher gemapped. Falls das Betriebssystem mmap versteht, wird dieser verwendet. Dabei wird die Datei nicht sofort komplett in den Speicher geladen, sondern nur die Teile, die gerade benötigt werden. Steht mmap nicht zur Verfügung, wird die Datei in den Hauptspeicher geladen. Die File-Klasse kümmert sich selbst daraum, dass der Speicher auch wieder freigegeben wird.

Ein mit Map gemappter Speicher darf nur gelesen, aber nicht beschrieben werden!

Rückgabe

Bei Erfolg gibt die Funktion einen Pointer auf den Speicherbereich zurück, in dem sich die Datei befindet, im Fehlerfall wirft die Funktion eine Exception

const char * ppl7::File::map ( ppluint64  position, size_t  size  )

virtual

Beschreibung:

Mit dieser Funktion wird ein Teil der Datei in den Speicher gemapped. Falls das Betriebssystem mmap versteht, wird dieser verwendet. Dabei wird der gewünschte Datenblock nicht sofort komplett in den Speicher geladen, sondern nur der Teil, auf den gerade zugegriffen wird. Steht mmap nicht zur Verfügung, wird die Datei in den Hauptspeicher geladen. Die File-Klasse kümmert sich selbst daraum, dass der Speicher auch wieder freigegeben wird.

Ein mit Map gemappter Speicher darf nur gelesen, aber nicht beschrieben werden! Falls auch geschrieben werden soll, ist die Funktion FileObject::MapRW zu verwenden.

Parameter

[in]	position	Die gewünschte Startposition innerhalb der Datei
[in]	size	Die Anzahl Bytes, die gemapped werden sollen.

Rückgabe

Bei Erfolg gibt die Funktion einen Pointer auf den Speicherbereich zurück, in dem sich die Datei befindet, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

char * ppl7::File::mapRW ( ppluint64  position, size_t  size  )

virtual

Beschreibung:

Mit dieser Funktion wird ein Teil der Datei in den Speicher gemapped. Falls das Betriebssystem mmap versteht, wird dieser verwendet. Dabei wird der gewünschte Datenblock nicht sofort komplett in den Speicher geladen, sondern nur der Teil, auf den gerade zugegriffen wird. Steht mmap nicht zur Verfügung, wird die Datei in den Hauptspeicher geladen. Die File-Klasse kümmert sich selbst daraum, dass der Speicher nach Gebrauch wieder zurück in die Datei geschrieben und freigegeben wird.

Ein mit mapRW gemappter Speicher darf sowohl gelesen als auch beschrieben werden! Bevor mit anderen Funktionen auf den gleichen Speicher zugegriffen werden soll (insbesondere schreibend), muss die Funktion FileObject::Unmap aufgerufen werden.

Parameter

[in]	position	Die gewünschte Startposition innerhalb der Datei
[in]	size	Die Anzahl Bytes, die gemapped werden sollen.

Rückgabe

Bei Erfolg gibt die Funktion einen Pointer auf den Speicherbereich zurück, in dem sich die Datei befindet, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

String ppl7::FileObject::md5 ( )

inherited

String ppl7::File::md5Hash ( const String &  filename )

static

void * ppl7::File::mmap ( ppluint64  position, size_t  size, int  prot, int  flags  )

private

int ppl7::File::munmap ( void *  addr, size_t  len  )

private

void ppl7::File::open	(	const String &	filename,
		FileMode	mode = READ
	)

Beschreibung:

Mit dieser Funktion wird eine Datei zum Lesen, Schreiben oder beides geöffnet.

Parameter

[in]	filename	Dateiname
	mode	Zugriffsmodus

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::File::open	(	const char *	filename,
		FileMode	mode = READ
	)

Beschreibung:

Mit dieser Funktion wird eine Datei zum Lesen, Schreiben oder beides geöffnet.

Parameter

filename	Dateiname als C-String
mode	String, der angibt, wie die Datei geöffnet werden soll (siehe ppl7_File_Filemodi)

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::File::open

(

FILE *

handle

)

Mit dieser Funktion kann eine mit der C-Funktion fopen bereits geöffnete Datei übernommen werden.

Parameter

[in]

handle

Das Filehandle

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::File::openTemp

(

const String &

filetemplate

)

Beschreibung:

Diese Funktion erzeugt eine temporäre Datei mit einem eindeutigen Namen. Dieser Name wird aus filetemplate erzeugt. Dazu müssen die letzten sechs Buchstaben des Parameters template XXXXXX sein, diese werden dann durch eine Zeichenkette ersetzt, die diesen Dateinamen eindeutig macht. Die Datei wird dann mit dem Modus read/write und den Rechten 0666 erzeugt.

Parameter

[in]

filetemplate

Pfad und Vorlage für den zu erstellenden Dateinamen

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::File::openTemp

(

const char *

filetemplate

)

Beschreibung:

Diese Funktion erzeugt eine temporäre Datei mit einem eindeutigen Namen. Dieser Name wird aus filetemplate erzeugt. Dazu müssen die letzten sechs Buchstaben des Parameters template XXXXXX sein, diese werden dann durch eine Zeichenkette ersetzt, die diesen Dateinamen eindeutig macht. Die Datei wird dann mit dem Modus read/write und den Rechten 0666 erzeugt.

Parameter

[in]

filetemplate

Pfad und Vorlage für den zu erstellenden Dateinamen als C-String

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::File::popen	(	const char *	command,
		FileMode	mode = READ
	)

Beschreibung:

Die Funktion Popen öffnet einen Prozess dadurch, dass sie sich nach Erzeugen einer Pipe aufteilt und eine Shell öffnet. Da eine Pipe nach Definition unidirektional ist, darf das Argument mode nur Lesen oder Schreiben angeben, nicht beides; der resultierende Datenkanal ist demzufolge nur-lesend oder nur-schreibend.

Parameter

[in]	command	Das Argument command enthält einen String, der ein Shell-Kommandozeile enthält. Dieses Kommando wird an /bin/sh unter Verwendung des Flags -c übergeben. Interpretation, falls nötig, wird von der Shell durchgeführt.
[in]	mode	Dateimodus

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::File::popen	(	const String &	command,
		FileMode	mode = READ
	)

Beschreibung:

Die Funktion Popen öffnet einen Prozess dadurch, dass sie sich nach Erzeugen einer Pipe aufteilt und eine Shell öffnet. Da eine Pipe nach Definition unidirektional ist, darf das Argument mode nur Lesen oder Schreiben angeben, nicht beides; der resultierende Datenkanal ist demzufolge nur-lesend oder nur-schreibend.

Parameter

[in]	command	Das Argument command enthält einen String, der ein Shell-Kommandozeile enthält. Dieses Kommando wird an /bin/sh unter Verwendung des Flags -c übergeben. Interpretation, falls nötig, wird von der Shell durchgeführt.
[in]	mode	Dateimodus

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

ppl7::File::PPL7EXCEPTION	(	IllegalFilemodeException	,
		Exception
	)

void ppl7::FileObject::puts ( const String &  str )

inherited

Beschreibung:

Diese Funktion schreibt den Inhalt des String-Objekts str ohne sein nachfolgendes 0-Byte in den Ausgabestrom.

Parameter

str	String-Objekt mit den zu schreibenden Daten

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::FileObject::putsf ( const char *  fmt,   ...  )

inherited

Beschreibung:

Putsf schreibt das Ergebnis nach Kontrolle des Formatierungsstrings fmt und Einsetzen der optionalen Parameter ohne sein nachfolgendes 0-Byte in den Ausgabestrom.

Parameter

fmt	Pointer auf den Formatierungsstring
...	Optionale Parameter, die im Formatierungsstring verwendet werden.

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

void ppl7::FileObject::putws ( const WideString &  str )

inherited

Beschreibung:

Diese Funktion schreibt den Inhalt des Wide-Character-String-Objekts str ohne sein nachfolgendes 0-Byte in den Ausgabestrom.

Parameter

str	String-Objekt mit den zu schreibenden Daten

Rückgabe

Kein Rückgabeparameter, im Fehlerfall wirft die Funktion eine Exception

size_t ppl7::FileObject::read ( void *  target, size_t  bytes, ppluint64  fileposition  )

inherited

Beschreibung:

Mit dieser Funktion wird beliebiger Bereich der geöffneten Datei in den Hauptspeicher geladen. Die Funktion ist nicht virtuell und existiert nur in der Basisklasse. Sie ruft die virtuellen Funktionen Seek und Fread auf, um den eigentlichen Lesevorgang durchzuführen.

Parameter

target	Pointer auf den Speicherbereich, in den die gelesenen Daten geschrieben werden sollen. Dieser muss zuvor vom Aufrufer allokiert worden sein und mindestens bytes gross sein.
bytes	Anzahl zu lesender Bytes
fileposition	Position in der Datei, an der die Daten gelesen werden sollen

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl gelesender Bytes zurück. Wenn ein Fehler auftritt oder das Dateiende erreicht ist, wird eine Exception geworfen.

size_t ppl7::FileObject::read ( void *  target, size_t  bytes  )

inherited

Beschreibung:

Diese Funktion liest bytes Bytes ab der aktuellen Position des Dateistroms und speichert sie im Hauptspeicher an der duch target bestimmten Position. Die Funktion ist nicht virtuell und existiert nur in der Basisklasse. Sie ruft die virtuellen Funktionen Seek und Fread auf, um den eigentlichen Lesevorgang durchzuführen.

Parameter

target	Pointer auf den Speicherbereich, in den die gelesenen Daten geschrieben werden sollen. Dieser muss zuvor vom Aufrufer allokiert worden sein und mindestens bytes gross sein.
bytes	Anzahl zu lesender Bytes

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl gelesender Bytes zurück. Wenn ein Fehler auftritt oder das Dateiende erreicht ist, wird eine Exception geworfen.

size_t ppl7::FileObject::read ( ByteArray &  target, size_t  bytes  )

inherited

Beschreibung:

Diese Funktion liest bytes Bytes ab der aktuellen Position des Dateistroms und speichert sie im Objekt target.

Die Funktion ist nicht virtuell und existiert nur in der Basisklasse. Sie ruft die virtuellen Funktionen Seek und Fread auf, um den eigentlichen Lesevorgang durchzuführen.

Parameter

target	Das Objekt, in dem die gelesenen Daten gespeichert werden sollen.
bytes	Anzahl zu lesender Bytes

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl gelesender Bytes zurück. Wenn ein Fehler auftritt oder das Dateiende erreicht ist, wird eine Exception geworfen.

void ppl7::File::rewind ( )

virtual

Beschreibung:

Diese Funktion bewegt den internen Dateizeiger an den Anfang der Datei

Erneute Implementation von ppl7::FileObject.

void ppl7::File::seek ( ppluint64  position )

virtual

Beschreibung:

Diese Funktion bewegt den internen Dateizeiger auf die gewünschte Stelle

Parameter

[in]

position

Gewünschte Position innerhalb der Datei

Ausnahmebehandlung

diverse

Erneute Implementation von ppl7::FileObject.

ppluint64 ppl7::File::seek ( pplint64  offset, SeekOrigin  origin  )

virtual

Beschreibung:

Die Funktion seek setzt den Dateipositionszeiger für den Stream. Die neue Position, gemessen in Byte, wird erreicht durch addieren von offset zu der Position, die durch origin angegeben ist. Wenn origin auf SEEK_SET, SEEK_CUR, oder SEEK_END, gesetzt ist, ist der Offset relativ zum Dateianfang, der aktuellen Position, oder dem Dateiende.

Ein erfolgreicher Aufruf der Funktion fseek löscht den Dateiendezeiger für den Stream.

Parameter

offset	Anzahl Bytes, die gesprungen werden soll.
origin	Gibt die Richtung an, in die der Dateizeiger bewegt werden soll. Es kann einen der folgenden Werte annehmen: SEEKSET offset wird vom Beginn der Datei berechnet SEEKCUR offset wird von der aktuellen Dateiposition gerechnet SEEKEND offset wird vom Ende der Datei aus nach vorne berechnet

Rückgabe

Liefert die neue Position zurück, wenn der Dateizeiger erfolgreich auf die gewünschte Position bewegt werden konnte. Im Fehlerfall wird eine Exception geworfen. Die Position des Schreib-/Lesezeigers ist in diesem Fall undefiniert und sollte mittels FileObject::ftell verifiziert werden.

Erneute Implementation von ppl7::FileObject.

void ppl7::FileObject::setFilename ( const char *  filename )

inherited

Include:

#include <ppl7.h>

Beschreibung:

Mit dieser Funktion wird der interne Dateiname festgelegt, der z.B. mit GetFilename ausgelesen werden kann. Die Funktion wird intern auch von den Open-Funktionen mit Dateinamen aufgerufen

Parameter

[in]	filename	Ein Formatstring oder der Dateiname
[in]	...	beliebig viele Parameter, sofern filename ein Formatstring ist

void ppl7::FileObject::setFilename ( const String &  filename )

inherited

Include:

#include <ppl7.h>

Beschreibung:

Mit dieser Funktion wird der interne Dateiname festgelegt, der z.B. mit GetFilename ausgelesen werden kann. Die Funktion wird intern auch von den Open-Funktionen mit Dateinamen aufgerufen

Parameter

[in]

filename

Ein CString, der den Dateinamen enthält.

void ppl7::File::setMapReadAhead ( size_t  bytes )

virtual

Beschreibung:

Falls mit Map viele aufeinanderfolgende kleine Speicherblöcke gemapped werden, ist es sinnvoll größere Blöcke zu laden, die dann bereits im Cache bzw. Hauptspeicher liegen, wenn sie gebraucht werden. Mit dieser Funktion kann bestimmt werden, wie viele Daten im Voraus gemapped werden sollen.

Parameter

bytes

Anzahl Bytes, die im Voraus gemapped werden sollen.

Erneute Implementation von ppl7::FileObject.

ppluint64 ppl7::File::size ( ) const

virtual

Beschreibung:

Diese Funktion liefert die Größe der geöffneten Datei in Bytes zurück.

Rückgabe

Größe der Datei in Bytes. Falls Fehler auftreten, wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

void ppl7::File::statFile ( const String &  filename, DirEntry &  result  )

static

Beschreibung:

Mit dieser statischen Funktion können Informationen zur Datei oder Verzeichnis filename ausgelesen werden. Das Ergebnis wird in result gespeichert.

Parameter

filename	Dateiname
result	Objekt, in dem die Daten gespeichert werden

Rückgabe

Kein Returnwert. Im Fehlerfall wird eine Exception geworfen.

Ausnahmebehandlung

NullPointerException	Wird geworfen, wenn filename auf NULL zeigt
FileNotFoundException	Datei oder Verzeichnis nicht vorhanden

DirEntry ppl7::File::statFile ( const String &  filename )

static

void ppl7::File::sync ( )

virtual

Beschreibung:

Für gewöhnlich cached das Betriebssysteme Schreibzugriffe auf die Festplatte, um die Performance zu steigern. Je nach Filesystem und Betriebssystem können zwischen Schreibzugriff der Software bis zum tatsächlichen Schreiben auf die Festplatte zwischen einigen wenigen Sekunden bis zu einer Minute vergehen! Tritt in diesem Zeitraum ein System-Crash oder Stromausfall auf, führt dies unweigerlich zu Datenverlust.

Ein Aufruf dieser Funktion bewirkt, dass alle Dateiänderungen sofort auf die Festplatte geschrieben werden. Sie sollte daher vor dem Schließen einer kritischen Datei mit CFile::Close aufgerufen werden, unter Umständen sogar nach jedem Schreibzugriff.

Rückgabe

Die Funktion kehrt erst zurück, wenn alle Daten vollständig geschrieben wurden und liefert dann true (1) zurück. Können die Daten nicht geschrieben werden, wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

ppluint64 ppl7::File::tell ( )

virtual

Beschreibung:

Die Funktion tell liefert den aktuellen Wert des Dateipositionszeigers für den Stream zurück.

Rückgabe

Position des Zeigers innerhalb der Datei. Im Fehlerfall wird eine Exception geworfen

Erneute Implementation von ppl7::FileObject.

void ppl7::File::throwErrno ( int  e )

private

Beschreibung:

Diese Funktion wird intern verwendet, um nach Auftreten eines Fehlers, anhand der globalen "errno"-Variablen die passende Exception zu werfen.

Parameter

e	Errorcode aus der errno-Variablen

void ppl7::File::throwErrno ( int  e, const String &  filename  )

static

Beschreibung:

Diese Funktion wird intern verwendet, um nach Auftreten eines Fehlers, anhand der globalen "errno"-Variablen die passende Exception zu werfen.

Parameter

e	Errorcode aus der errno-Variablen
filename	Dateiname, bei der der Fehler aufgetreten ist

void ppl7::File::truncate ( ppluint64  length )

virtual

Beschreibung:

Die Funktionen Truncate bewirkt, dass die aktuell geöffnete Datei auf eine Größe von exakt length Bytes abgeschnitten wird.

Wenn die Datei vorher größer war, gehen überschüssige Daten verloren. Wenn die Datei vorher kleiner war, wird sie vergrößert und die zusätzlichen Bytes werden als Nullen geschrieben.

Der Dateizeiger wird nicht verändert. Die Datei muss zum Schreiben geöffnet sein.

Parameter

length

Position, an der die Datei abgeschnitten werden soll.

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Erneute Implementation von ppl7::FileObject.

void ppl7::File::unlock ( )

virtual

Beschreibung:

Mit Unlock wird eine mit lockShared oder lockExclusive eingerichtete Sperre wieder aufgehoben, so dass auch andere Prozesse wieder uneingeschränkt auf die Datei zugreifen können.

Rückgabe

Kein Rückgabewert, im Fehlerfall wird eine Exception geworfen.

Siehe auch

Siehe auch FileObject::lockShared und FileObject::lockExclusive

Erneute Implementation von ppl7::FileObject.

void ppl7::File::unmap ( )

virtual

Beschreibung:

Ein mit map oder mapRW eingerichtetes Mapping einer Datei in den Hauptspeicher wird wieder aufgehoben.

Erneute Implementation von ppl7::FileObject.

size_t ppl7::FileObject::write ( const void *  source, size_t  bytes, ppluint64  fileposition  )

inherited

Beschreibung:

Mit dieser Funktion wird ein beliebiger Speicherbereich auf den Datenträger geschrieben. Die Funktion ist nicht virtuell und existiert nur in der Basisklasse. Sie ruft die virtuellen Funktionen Seek und Fwrite auf, um den eigentlichen Schreibvorgang durchzuführen.

Parameter

source	Pointer auf den Speicherbereich, der geschrieben werden soll
bytes	Anzahl zu schreibender Bytes
fileposition	Position in der Datei, an der die Daten gespeichert werden solle

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl geschriebener Bytes zurück, im Fehlerfall wird eine Exception geworfen.

size_t ppl7::FileObject::write ( const void *  source, size_t  bytes  )

inherited

Beschreibung:

Mit dieser Funktion wird ein beliebiger Speicherbereich auf den Datenträger geschrieben. Die Funktion ist nicht virtuell und existiert nur in der Basisklasse. Sie ruft die virtuellen Funktionen Seek und Fwrite auf, um den eigentlichen Schreibvorgang durchzuführen.

Parameter

source	Pointer auf den Speicherbereich, der geschrieben werden soll
bytes	Anzahl zu schreibender Bytes

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl geschriebener Bytes zurück, im Fehlerfall wird eine Exception geworfen.

size_t ppl7::FileObject::write ( const ByteArrayPtr &  object, size_t  bytes = 0  )

inherited

Beschreibung:

Mit dieser Funktion wird der Speicherinhalt eines Variant-Objekts auf den Datenträger geschrieben. Die Funktion ist nicht virtuell und existiert nur in der Basisklasse. Sie ruft die virtuellen Funktionen Seek und fwrite auf, um den eigentlichen Schreibvorgang durchzuführen.

Parameter

object	Das zu speichernde Variant Objekt
bytes	Anzahl zu schreibender Bytes

Rückgabe

Bei Erfolg liefert die Funktion die Anzahl geschriebener Bytes zurück, im Fehlerfall wird eine Exception geworfen.

Dokumentation der Datenelemente

char* ppl7::FileObject::buffer

protectedinherited

void* ppl7::File::ff

private

bool ppl7::File::isPopen

private

int ppl7::File::LastMapProtection

private

ppluint64 ppl7::File::LastMapSize

private

ppluint64 ppl7::File::LastMapStart

private

char* ppl7::File::MapBase

private

ppluint64 ppl7::File::mysize

private

ppluint64 ppl7::File::pos

private

ppluint64 ppl7::File::ReadAhead

private

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien:

• /jenkins/jobs/clang_ppl7/workspace/include/ppl7.h
• /jenkins/jobs/clang_ppl7/workspace/src/core/File.cpp