eut::FileHelper-Namensbereichsreferenz

Helfer mit statischen Methoden zur Bearbeitung des Filesystems. Mehr ...

Klassen
class	CallBackFileDirFount

Typdefinitionen
typedef void(*	PROCESSING_FILE_MEMBERPTR) (const fs::path &rFullFileName)
typedef void(*	PROCESSING_DIR_MEMBERPTR) (const fs::path &rFullPathName)

Funktionen
__tool_export_dll int	storeFile (const std::string &rsStr, const std::string &rsFileName)
__tool_export_dll int	lockFile (std::ofstream *&prLockFile, const std::string &rsLockFileName)
__tool_export_dll int	loadFile (std::string &rstr, const std::string &rsFileName)
__tool_export_dll int	closeInputFile (std::ifstream *&pFileStream)
__tool_export_dll int	closeInputFile (std::wifstream *&pFileStream)
__tool_export_dll int	closeOutputFile (std::ofstream *&pFileStream)
__tool_export_dll int	closeOutputFile (std::wofstream *&pFileStream)
__tool_export_dll int	dirExist (const std::string &rsCheckPath)
__tool_export_dll int	dirExist (const std::wstring &rsCheckPath)
__tool_export_dll std::string	getCurrentWorkingDirAsString ()
__tool_export_dll std::wstring	getCurrentWorkingDirAsWString ()
__tool_export_dll int	fileExist (const std::string &rsFullFileName)
__tool_export_dll int	fileExist (const std::wstring &rsFullFileName)
__tool_export_dll int	copyFile (const std::string &rsSourceFileName, const std::string &rsTargetFileName)
__tool_export_dll int	deleteFile (const std::string &rsFullFileName)
__tool_export_dll int	deleteFile (const fs::path &rFullFileName)
__tool_export_dll void	deleteFileForIterateDirectory (const fs::path &rFullFileName)
int	_iterateDirectory (const fs::path &rIterPath, bool bRecursive, PROCESSING_FILE_MEMBERPTR ProcessingFileFunction, PROCESSING_DIR_MEMBERPTR ProcessingDirFunction, CallBackFileDirFount *pProcessingObject)
__tool_export_dll int	iterateDirectory (const fs::path &rIterPath, bool bRecursive, PROCESSING_FILE_MEMBERPTR ProcessingFileFunction, PROCESSING_DIR_MEMBERPTR ProcessingDirFunction)
__tool_export_dll int	iterateDirectory (const fs::path &rIterPath, bool bRecursive, CallBackFileDirFount &rProcessingObject)
__tool_export_dll int	storeFile (char *pszData, std::streamsize nSize, const std::string &rsFileName)
	Speichert Daten in eine Datei im Filesystem.
__tool_export_dll int	storeFile (char *pszData, std::streamsize nSize, const std::wstring &rsFileName)
	Speichert Daten in eine Datei im Filesystem.
__tool_export_dll int	storeFile (const Blob *pBlob, const std::string &rsFileName)
	Speichert den Inhalt eines Blobs in eine Datei im Filesystem.
__tool_export_dll int	storeFile (const Blob *pBlob, const std::wstring &rsFileName)
	Speichert den Inhalt eines Blobs in eine Datei im Filesystem.
__tool_export_dll int	storeFile (const Blob &rBlob, const std::string &rsFileName)
	Speichert den Inhalt eines Blobs in eine Datei im Filesystem.
__tool_export_dll int	storeFile (const Blob &rBlob, const std::wstring &rsFileName)
	Speichert den Inhalt eines Blobs in eine Datei im Filesystem.
__tool_export_dll int	loadFile (char *&prszData, std::streamsize &rnSize, const std::string &rsFileName, bool bText=false)
	Liefert den Inhalt und die Größe einer Datei aus dem Filesystem.
__tool_export_dll int	loadFile (char *&prszData, std::streamsize &rnSize, const std::wstring &rsFileName, bool bText=false)
	Liefert den Inhalt und die Größe einer Datei aus dem Filesystem.
__tool_export_dll int	loadFile (Blob *&prBlob, const std::string &rsFileName)
__tool_export_dll int	loadFile (Blob *&prBlob, const std::wstring &rsFileName)
__tool_export_dll int	loadFile (Blob &rBlob, const std::string &rsFileName)
	Liefert den Inhalt einer Datei aus dem Filesystem.
__tool_export_dll int	loadFile (Blob &rBlob, const std::wstring &rsFileName)
	Liefert den Inhalt einer Datei aus dem Filesystem.
__tool_export_dll int	openInputFile (std::ifstream *&pInputFileStream, const std::string &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::ifstream zum Schreiben im Filesystem.
__tool_export_dll int	openInputFile (std::ifstream *&pInputFileStream, const std::wstring &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::ifstream zum Schreiben im Filesystem.
__tool_export_dll int	openInputFile (std::wifstream *&pInputFileStream, const std::string &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::wifstream zum Schreiben im Filesystem.
__tool_export_dll int	openInputFile (std::wifstream *&pInputFileStream, const std::wstring &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::wifstream zum Schreiben im Filesystem.
__tool_export_dll int	openOutputFile (std::ofstream *&pOutputFileStream, const std::string &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::ofstream zum Lesen im Filesystem.
__tool_export_dll int	openOutputFile (std::ofstream *&pOutputFileStream, const std::wstring &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::ofstream zum Lesen im Filesystem.
__tool_export_dll int	openOutputFile (std::wofstream *&pOutputFileStream, const std::string &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::wofstream zum Lesen im Filesystem.
__tool_export_dll int	openOutputFile (std::wofstream *&pOutputFileStream, const std::wstring &rsFileName)
	Liefert eine geöffnete Datei vom Typ std::wofstream zum Lesen im Filesystem.
__tool_export_dll int	makeDir (const std::string &rsNewPath)
	Kreiert übergebene(s) Verzeichnis(se).
__tool_export_dll int	makeDir (const std::wstring &rsNewPath)
	Kreiert übergebene(s) Verzeichnis(se).
__tool_export_dll int	makePath (const std::string &rsNewPath)
	Kreiert übergebene(s) Verzeichnis(se).
__tool_export_dll int	makePath (const std::wstring &rsNewPath)
	Kreiert übergebene(s) Verzeichnis(se).
__tool_export_dll void	splitPath (const std::string &rsFullFileName, std::string &rsDrive, std::string &rsPath, std::string &rsFileName, std::string &rsFileExtension)
	Erwartet einen Dateinamen inkl.
__tool_export_dll void	splitPath (const std::wstring &rsFullFileName, std::wstring &rsDrive, std::wstring &rsPath, std::wstring &rsFileName, std::wstring &rsFileExtension)
	Erwartet einen Dateinamen inkl.
__tool_export_dll void	getFullFileName (std::string &rsFullFileName, const fs::path &rFileSystemPath, const char &rSeparator='/')
	Setzt im übergebenen String den vollen Dateinamen aus dem übergebenen fs::path, auch wenn dieser nur rellativ ist.
__tool_export_dll void	getFullFileName (std::wstring &rsFullFileName, const fs::path &rFileSystemPath, const std::wstring &rSeparator=L"/")
	Setzt im übergebenen String den vollen Dateinamen aus dem übergebenen fs::path, auch wenn dieser nur rellativ ist.
int	_getswapDatavalue (std::string &sOutText, const std::string &sInText, const std::string &sTextOrFile)
	Hilfsfunktion für swapDataInFile (...) die einen Wert in einem std::string liefert, der entweder aus einer Datei kommt, bzw.
int	_getswapDatavalue (std::string &sOutText, const std::wstring &sInText, const std::string &sTextOrFile)
	Hilfsfunktion für swapDataInFile (...) die einen Wert in einem std::string liefert, der entweder aus einer Datei kommt, bzw.
__tool_export_dll int	swapDataInFile (std::vector< std::string > &rParamVector, bool bSimulate=false)
	Sucht und ersetzt Inhalte in Dateien und speichert diese ggf.

Ausführliche Beschreibung

Helfer mit statischen Methoden zur Bearbeitung des Filesystems.

Zu beachten

Einige Funktionen sind nur verfügbar, wenn verschiedene Präprozessor-Direktive gesetzt wurden.

• __EUFILEHELPER_WITH_EUBLOB Bei dieser Präprozessor-Direktive werden die Funktionen verfügbar, die ein Objekt vom Typ Blob erwarten.
• _HAS_FILESYSTEM Einige Funktionen benötigen <filesystem> (ab c++17).
  Diese Präprozessor-Direktive wird in der Header gesetzt und sollte nur dort erweitert werden.

Copyright

© 2010 Helmut Jakoby

Autor

Helmut Jakoby

Dokumentation der benutzerdefinierten Typen

PROCESSING_DIR_MEMBERPTR

typedef void(* eut::FileHelper::PROCESSING_DIR_MEMBERPTR) (const fs::path &rFullPathName)

Definitionen des Funktions-Zeigers für FileHelper::iterateDirectory (...), die aufgerufen wird, wenn beim Iterieren ein Pfad gefunden wird.

Parameter

[in]

rFullPathName

Der vollständigee Pfad in einem Objekts des Typs fs::path.

Zu beachten

Diese Typdefinitionen werden nur vorgenommen, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

PROCESSING_FILE_MEMBERPTR

typedef void(* eut::FileHelper::PROCESSING_FILE_MEMBERPTR) (const fs::path &rFullFileName)

Definitionen des Funktions-Zeigers für FileHelper::iterateDirectory (...), die aufgerufen wird, wenn beim Iterieren eine Datei gefunden wird.

Parameter

[in]

rFullFileName

Der Dateiname mit vollständigem Pfad in einem Objekts des Typs fs::path.

Zu beachten

Diese Typdefinitionen werden nur vorgenommen, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

Dokumentation der Funktionen

_getswapDatavalue() [1/2]

int eut::FileHelper::_getswapDatavalue	(	std::string &	sOutText,
		const std::string &	sInText,
		const std::string &	sTextOrFile )

Hilfsfunktion für swapDataInFile (...) die einen Wert in einem std::string liefert, der entweder aus einer Datei kommt, bzw.

als regulärer Ausdruck oder als Text ermittelt wird.

Parameter

[in,out]	sOutText	Der ermittelte Wert.
[in]	sInText	Der Wert nach dem sTextOrFile Wert.
[in]	sTextOrFile	Der auszuwertende Ausdruck (siehe Beschreibung swapDataInFile (...) rParamVector[1] und rParamVector[2].

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

_getswapDatavalue() [2/2]

int eut::FileHelper::_getswapDatavalue	(	std::string &	sOutText,
		const std::wstring &	sInText,
		const std::string &	sTextOrFile )

Hilfsfunktion für swapDataInFile (...) die einen Wert in einem std::string liefert, der entweder aus einer Datei kommt, bzw.

als regulärer Ausdruck oder als Text ermittelt wird.

Parameter

[in,out]	sOutText	Der ermittelte Wert.
[in]	sInText	Der Wert nach dem sTextOrFile Wert.
[in]	sTextOrFile	Der auszuwertende Ausdruck (siehe Beschreibung swapDataInFile (...) rParamVector[1] und rParamVector[2].

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

_iterateDirectory()

int eut::FileHelper::_iterateDirectory	(	const fs::path &	rIterPath,
		bool	bRecursive,
		PROCESSING_FILE_MEMBERPTR	ProcessingFileFunction,
		PROCESSING_DIR_MEMBERPTR	ProcessingDirFunction,
		CallBackFileDirFount *	pProcessingObject )

Fasst die Funktionen FileHelper::iterateDirectory( const fs::path & rIterPath, bool bRecursive, PROCESSING_FILE_MEMBERPTR ProcessingFileFunction, PROCESSING_DIR_MEMBERPTR ProcessingDirFunction ) und FileHelper::iterateDirectory( const fs::path & rIterPath, bool bRecursive, CallBackFileDirFount & rProcessingObject ) zusammen bzw. wird von diesen aufgerufen.

Parameter

[in]	rIterPath	Der Pfad; kann auch rellativ sein, durch den iteriert wird.
[in]	bRecursive	Wenn true, wird auch durch ggf. vorhandenen Unterverzeichnisse itereiert.
[in]	ProcessingFileFunction	Ein Pointer auf eine Funktion, welche bei jeder gefundnenen Datei aufgerufen wird.
[in]	ProcessingDirFunction	Ein Pointer auf eine Funktion, welche bei jedem gefundnenen Verzeichnis aufgerufen wird.
[in]	pProcessingObject	Zeiger auf ein abgeleitetes CallBackFileDirFount -Objekt; wenn nicht nullptr, werden dessen Methoden aufgerufen.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

closeInputFile() [1/2]

__tool_export_dll int eut::FileHelper::closeInputFile

(

std::ifstream *&

pFileStream

)

Schliesst eine Datei vom Typ std::ifstream im Filesystem.

Parameter

[in,out]

pFileStream

Zeiger-Referenz auf einen Input-Filestream welcher die geöffnete Datei repräsentiert.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Input-Filestream geliefert wurde, ist dieser geschlossen und aus dem Speicher entfernt und auf 0 gesetzt.

closeInputFile() [2/2]

__tool_export_dll int eut::FileHelper::closeInputFile

(

std::wifstream *&

pFileStream

)

Schliesst eine Datei vom Typ std::wifstream im Filesystem.

Parameter

[in,out]

pFileStream

Zeiger-Referenz auf einen Input-Filestream welcher die geöffnete Datei repräsentiert.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Input-Filestream geliefert wurde, ist dieser geschlossen und aus dem Speicher entfernt und auf 0 gesetzt.

closeOutputFile() [1/2]

__tool_export_dll int eut::FileHelper::closeOutputFile

(

std::ofstream *&

pFileStream

)

Schliesst eine Datei vom Typ std::ofstream im Filesystem.

Parameter

[in,out]

pFileStream

Zeiger-Referenz auf einen Output-Filestream welcher die geöffnete Datei repräsentiert.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Output-Filestream geliefert wurde, ist dieser geschlossen und aus dem Speicher entfernt und auf 0 gesetzt.

closeOutputFile() [2/2]

__tool_export_dll int eut::FileHelper::closeOutputFile

(

std::wofstream *&

pFileStream

)

Schliesst eine Datei vom Typ std::wofstream im Filesystem.

Parameter

[in,out]

pFileStream

Zeiger-Referenz auf einen Output-Filestream welcher die geöffnete Datei repräsentiert.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Output-Filestream geliefert wurde, ist dieser geschlossen und aus dem Speicher entfernt und auf 0 gesetzt.

copyFile()

__tool_export_dll int eut::FileHelper::copyFile	(	const std::string &	rsSourceFileName,
		const std::string &	rsTargetFileName )

Kopiert übergebene Datei.

Parameter

[in]	rsSourceFileName	Der vollständige Dateiname (z.B. "c:\\temp\\SourceText.txt") der zu kopierenden Datei.
[in]	rsTargetFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TargetText.txt") der neu zu erstellenden bzw. zu überschreibenden Datei.

Rückgabe

Liefert 1, wenn Kopierent erfolgreich bzw. 0 wenn nicht. Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

In Visual Studio muss in der Präprozessordefinitiondie _CRT_SECURE_NO_WARNINGS gesetzt werden.

deleteFile() [1/2]

__tool_export_dll int eut::FileHelper::deleteFile

(

const fs::path &

rFullFileName

)

Eine Funktion, welche versucht die übergebene Datei aus dem Dateisystem zu löschen.

Parameter

[in]

rFullFileName

Der Dateiname mit vollständigem Pfad in einem Objekts des Typs fs::path.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

deleteFile() [2/2]

__tool_export_dll int eut::FileHelper::deleteFile

(

const std::string &

rsFullFileName

)

Eine Funktion, welche versucht die übergebene Datei aus dem Dateisystem zu löschen.

Parameter

[in]

rsFullFileName

Der Dateiname mit vollständigem Pfad.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

deleteFileForIterateDirectory()

__tool_export_dll void eut::FileHelper::deleteFileForIterateDirectory

(

const fs::path &

rFullFileName

)

Eine Funktion, welche versucht die übergebene Datei aus dem Dateisystem zu löschen.
Es wird nichts unternommen oder gemeldet, wenn dieses aus irgendwelchen Gründen nicht gelingt.
Es wird keine ggf. auftretende Exception gefangen und/oder bearbeitet.
Diese Funktion kann als 3. Parameter für
iterateDirectory( const fs::path & rIterPath, bool bRecursive, PROCESSING_FILE_MEMBERPTR ProcessingFileFunction, PROCESSING_DIR_MEMBERPTR ProcessingDirFunction )
genutzt werden.

Parameter

[in]

rFullFileName

Der Dateiname mit vollständigem Pfad in einem Objekts des Typs fs::path.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.
Wenn eine Fehlerauswertung gewünscht ist, kann Funktion void deleteFile(const fs::path&) genutzt werden.

Siehe auch

iterateDirectory(const fs::path&,bool, PROCESSING_FILE_MEMBERPTR, PROCESSING_DIR_MEMBERPTR)

dirExist() [1/2]

__tool_export_dll int eut::FileHelper::dirExist

(

const std::string &

rsCheckPath

)

Prüft ob ein Verzeichnis im Dateisystem existiert.

Parameter

[in]

rsCheckPath

Der vollständige Verzeichnissname des zu prüfenden Verzeichnisses.

Rückgabe

Liefert 1, wenn übergebenes Verzeichnis vorhanden ist, 0 wenn nicht und - 1 wenn Name schon als Dateiname vergeben ist.

Zu beachten

Kennt nur ASCII.

dirExist() [2/2]

__tool_export_dll int eut::FileHelper::dirExist

(

const std::wstring &

rsCheckPath

)

Prüft ob ein Verzeichnis im Dateisystem existiert.

Parameter

[in]

rsCheckPath

Der vollständige Verzeichnissname des zu prüfenden Verzeichnisses.

Rückgabe

Liefert 1, wenn übergebenes Verzeichnis vorhanden ist, 0 wenn nicht und - 1 wenn Name schon als Dateiname vergeben ist.

fileExist() [1/2]

__tool_export_dll int eut::FileHelper::fileExist

(

const std::string &

rsFullFileName

)

Prüft ob eine Datei im Filesystem existiert.

Parameter

[in]

rsFullFileName

Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Liefert 1, wenn übergebens File vorhanden ist, 0 wenn nicht und - 1 wenn Name schon als Verzeichnisname vergeben ist.

fileExist() [2/2]

__tool_export_dll int eut::FileHelper::fileExist

(

const std::wstring &

rsFullFileName

)

Prüft ob eine Datei im Filesystem existiert.

Parameter

[in]

rsFullFileName

Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Liefert 1, wenn übergebens File vorhanden ist, 0 wenn nicht und - 1 wenn Name schon als Verzeichnisname vergeben ist.

getCurrentWorkingDirAsString()

__tool_export_dll std::string eut::FileHelper::getCurrentWorkingDirAsString

(

)

Liefert das aktuelle Arbeitsverzeichnis.

Rückgabe

Das aktuelle Arbeistverzeichnis.

getCurrentWorkingDirAsWString()

__tool_export_dll std::wstring eut::FileHelper::getCurrentWorkingDirAsWString

(

)

Liefert das aktuelle Arbeitsverzeichnis.

Rückgabe

Das aktuelle Arbeistverzeichnis.

getFullFileName() [1/2]

__tool_export_dll void eut::FileHelper::getFullFileName	(	std::string &	rsFullFileName,
		const fs::path &	rFileSystemPath,
		const char &	rSeparator = '/' )

Setzt im übergebenen String den vollen Dateinamen aus dem übergebenen fs::path, auch wenn dieser nur rellativ ist.

Parameter

[in,out]	rsFullFileName	Der ermittelte Pfad.
[in]	rFileSystemPath	Der Filesystem-Path aus dem der vollständige Dateiname ermittelt wird.
[in]	rSeparator	Der Pfad-Separator. Es sind nur die Zeichen '/' oder '\' erlaubt. Bei einem anderen Zeichen wird ohne Exception '/' genommen.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

getFullFileName() [2/2]

__tool_export_dll void eut::FileHelper::getFullFileName	(	std::wstring &	rsFullFileName,
		const fs::path &	rFileSystemPath,
		const std::wstring &	rSeparator = L"/" )

Setzt im übergebenen String den vollen Dateinamen aus dem übergebenen fs::path, auch wenn dieser nur rellativ ist.

Parameter

[in,out]	rsFullFileName	Der ermittelte Pfad.
[in]	rFileSystemPath	Der Filesystem-Path aus dem der vollständige Dateiname ermittelt wird.
[in]	rSeparator	Der Pfad-Separator. Es sind nur die Zeichen '/' oder '\' erlaubt. Bei einem anderen Zeichen wird ohne Exception '/' genommen.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

iterateDirectory() [1/2]

__tool_export_dll int eut::FileHelper::iterateDirectory	(	const fs::path &	rIterPath,
		bool	bRecursive,
		CallBackFileDirFount &	rProcessingObject )

Es wird durch übergebenen Pfad (Parameter 'rIterPath') iteriert und für jede Datei bzw. jedes Verzeichnis im übergebenen CallBackFileDirFount die entsprechende Methoden CallBackFileDirFount::processDirFount (...) bzw. CallBackFileDirFount::processFileFount (...) aufgerufen.

Parameter

[in]	rIterPath	Der Pfad; kann auch rellativ sein, durch den iteriert wird.
[in]	bRecursive	Wenn true, wird auch durch ggf. vorhandenen Unterverzeichnisse itereiert.
[in]	rProcessingObject	Referenz auf ein abgeleitetes CallBackFileDirFount.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

iterateDirectory() [2/2]

__tool_export_dll int eut::FileHelper::iterateDirectory	(	const fs::path &	rIterPath,
		bool	bRecursive,
		PROCESSING_FILE_MEMBERPTR	ProcessingFileFunction,
		PROCESSING_DIR_MEMBERPTR	ProcessingDirFunction )

Es wird durch übergebenen Pfad (Parameter 'rIterPath') iteriert und wenn entsprechende Funktionspointer übergeben sind, diese jeweils für eine Directory bzw. eine Datei aufgerufen.

Parameter

[in]	rIterPath	Der Pfad; kann auch rellativ sein, durch den iteriert wird.
[in]	bRecursive	Wenn true, wird auch durch ggf. vorhandenen Unterverzeichnisse itereiert.
[in]	ProcessingFileFunction	Ein Pointer auf eine Funktion, welche bei jeder gefundnenen Datei aufgerufen wird.
[in]	ProcessingDirFunction	Ein Pointer auf eine Funktion, welche bei jedem gefundnenen Verzeichnis aufgerufen wird.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive _HAS_FILESYSTEM definiert ist.

loadFile() [1/7]

__tool_export_dll int eut::FileHelper::loadFile	(	Blob &	rBlob,
		const std::string &	rsFileName )

Liefert den Inhalt einer Datei aus dem Filesystem.

Parameter

[in,out]	rBlob	Referenz auf den Blob, in dem der Inhalt der Datei eingefügt wird.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

Es wird das übergebene Blob 'verantwortlich' gesetzt (siehe Blob::setMemResponsible( bool bActiv ) ).

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

loadFile() [2/7]

__tool_export_dll int eut::FileHelper::loadFile	(	Blob &	rBlob,
		const std::wstring &	rsFileName )

Liefert den Inhalt einer Datei aus dem Filesystem.

Parameter

[in,out]	rBlob	Referenz auf den Blob, in dem der Inhalt der Datei eingefügt wird.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

Es wird das übergebene Blob 'verantwortlich' gesetzt (siehe Blob::setMemResponsible( bool bActiv ) ).

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

loadFile() [3/7]

__tool_export_dll int eut::FileHelper::loadFile	(	Blob *&	prBlob,
		const std::string &	rsFileName )

Liefert den Inhalt einer Datei aus dem Filesystem.

Parameter

[in,out]	prBlob	Zeiger-Referenz auf ein neues Blob, in dem der Inhalt der Datei gespeichert ist.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

Von dieser Methode wird für übergebenes prBlob Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

loadFile() [4/7]

__tool_export_dll int eut::FileHelper::loadFile	(	Blob *&	prBlob,
		const std::wstring &	rsFileName )

Liefert den Inhalt einer Datei aus dem Filesystem.

Parameter

[in,out]	prBlob	Zeiger-Referenz auf ein neues Blob, in dem der Inhalt der Datei gespeichert ist.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

Von dieser Methode wird für übergebenes prBlob Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

loadFile() [5/7]

__tool_export_dll int eut::FileHelper::loadFile	(	char *&	prszData,
		std::streamsize &	rnSize,
		const std::string &	rsFileName,
		bool	bText = false )

Liefert den Inhalt und die Größe einer Datei aus dem Filesystem.

Parameter

[in,out]	prszData	Zeiger-Referenz auf den Speicher, in dem der Inhalt der Datei gespeichert ist.
[in,out]	rnSize	Größe der gespeicherten Datei.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").
[in]	bText	Wenn true wird an die Dateidaten in prszData eine 0 angehängt.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

Von dieser Methode wird für prszData Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß.

loadFile() [6/7]

__tool_export_dll int eut::FileHelper::loadFile	(	char *&	prszData,
		std::streamsize &	rnSize,
		const std::wstring &	rsFileName,
		bool	bText = false )

Liefert den Inhalt und die Größe einer Datei aus dem Filesystem.

Parameter

[in,out]	prszData	Zeiger-Referenz auf den Speicher, in dem der Inhalt der Datei gespeichert ist.
[in,out]	rnSize	Größe der gespeicherten Datei.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").
[in]	bText	Wenn true wird an die Dateidaten in prszData eine 0 angehängt.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung

Von dieser Methode wird für prszData Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß.

loadFile() [7/7]

__tool_export_dll int eut::FileHelper::loadFile	(	std::string &	rstr,
		const std::string &	rsFileName )

Liefert den Inhalt einer Datei aus dem Filesystem in einem std::string.

Parameter

[in,out]	rstr	Der std::string, in dem der Inhalt der Dateit ist.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

lockFile()

__tool_export_dll int eut::FileHelper::lockFile	(	std::ofstream *&	prLockFile,
		const std::string &	rsLockFileName )

Sperrt eine Datei im Filesystem.

Parameter

[in,out]	prLockFile	Das gesperrte LockFile.
[in]	rsLockFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn prLockFile, muss dieses einfach aus dem Speicher entfernt werden, um die Sperre aufzuheben.

makeDir() [1/2]

__tool_export_dll int eut::FileHelper::makeDir

(

const std::string &

rsNewPath

)

Kreiert übergebene(s) Verzeichnis(se).

Parameter

[in]

rsNewPath

Der vollständige Verzeichnissname. Es wird nicht der gesamte Pfad erstellt, sondern nur das letzte Verzeichnis, wenn die Oberverzeichnisse vorhanden sind. Siehe auch int FileHelper::makePath (...).

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

makeDir() [2/2]

__tool_export_dll int eut::FileHelper::makeDir

(

const std::wstring &

rsNewPath

)

Kreiert übergebene(s) Verzeichnis(se).

Parameter

[in]

rsNewPath

Der vollständige Verzeichnissname. Es wird nicht der gesamte Pfad erstellt, sondern nur das letzte Verzeichnis, wenn die Oberverzeichnisse vorhanden sind. Siehe auch int FileHelper::makePath (...).

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

makePath() [1/2]

__tool_export_dll int eut::FileHelper::makePath

(

const std::string &

rsNewPath

)

Kreiert übergebene(s) Verzeichnis(se).

Parameter

[in]

rsNewPath

Der vollständige Verzeichnissname. Es werden, wenn noch nicht vorhanden, alle Verzeichnisse erstellt.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

makePath() [2/2]

__tool_export_dll int eut::FileHelper::makePath

(

const std::wstring &

rsNewPath

)

Kreiert übergebene(s) Verzeichnis(se).

Parameter

[in]

rsNewPath

Der vollständige Verzeichnissname. Es werden, wenn noch nicht vorhanden, alle Verzeichnisse erstellt.

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

openInputFile() [1/4]

__tool_export_dll int eut::FileHelper::openInputFile	(	std::ifstream *&	pInputFileStream,
		const std::string &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::ifstream zum Schreiben im Filesystem.

Parameter

[in,out]	pInputFileStream	Zeiger-Referenz auf einen Input-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Input-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pInputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int FileHelper::closeInputFile( std::ifstream *& pFileStream ) genutzt werden.

openInputFile() [2/4]

__tool_export_dll int eut::FileHelper::openInputFile	(	std::ifstream *&	pInputFileStream,
		const std::wstring &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::ifstream zum Schreiben im Filesystem.

Parameter

[in,out]	pInputFileStream	Zeiger-Referenz auf einen Input-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Input-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pInputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int FileHelper::closeInputFile( std::ifstream *& pFileStream ) genutzt werden.

openInputFile() [3/4]

__tool_export_dll int eut::FileHelper::openInputFile	(	std::wifstream *&	pInputFileStream,
		const std::string &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::wifstream zum Schreiben im Filesystem.

Parameter

[in,out]	pInputFileStream	Zeiger-Referenz auf einen Input-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Input-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pInputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int FileHelper::closeInputFile( std::wifstream *& pFileStream ) genutzt werden.

openInputFile() [4/4]

__tool_export_dll int eut::FileHelper::openInputFile	(	std::wifstream *&	pInputFileStream,
		const std::wstring &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::wifstream zum Schreiben im Filesystem.

Parameter

[in,out]	pInputFileStream	Zeiger-Referenz auf einen Input-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Input-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pInputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int FileHelper::closeInputFile( std::wifstream *& pFileStream ) genutzt werden.

openOutputFile() [1/4]

__tool_export_dll int eut::FileHelper::openOutputFile	(	std::ofstream *&	pOutputFileStream,
		const std::string &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::ofstream zum Lesen im Filesystem.

Parameter

[in,out]	pOutputFileStream	Zeiger-Referenz auf einen Output-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Output-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pOutputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int closeOutputFile( std::ofstream *& pFileStream ) genutzt werden.

openOutputFile() [2/4]

__tool_export_dll int eut::FileHelper::openOutputFile	(	std::ofstream *&	pOutputFileStream,
		const std::wstring &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::ofstream zum Lesen im Filesystem.

Parameter

[in,out]	pOutputFileStream	Zeiger-Referenz auf einen Output-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Output-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pOutputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int closeOutputFile( std::ofstream *& pFileStream ) genutzt werden.

openOutputFile() [3/4]

__tool_export_dll int eut::FileHelper::openOutputFile	(	std::wofstream *&	pOutputFileStream,
		const std::string &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::wofstream zum Lesen im Filesystem.

Parameter

[in,out]	pOutputFileStream	Zeiger-Referenz auf einen Output-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Output-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pOutputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int closeOutputFile( std::wofstream *& pFileStream ) genutzt werden.

openOutputFile() [4/4]

__tool_export_dll int eut::FileHelper::openOutputFile	(	std::wofstream *&	pOutputFileStream,
		const std::wstring &	rsFileName )

Liefert eine geöffnete Datei vom Typ std::wofstream zum Lesen im Filesystem.

Parameter

[in,out]	pOutputFileStream	Zeiger-Referenz auf einen Output-Filestream welcher die geöffnete Datei repräsentiert.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Wenn ein gültiger Output-Filestream geliefert wurde, muss die aufrufende Instanz diesen wieder schließen. Es wird für übergebenen pOutputFileStream Speicher allokiert, welcher von der aufrufenden Instanz wieder freigegeben werden muß. Dafür kann die Funktion int closeOutputFile( std::wofstream *& pFileStream ) genutzt werden.

splitPath() [1/2]

__tool_export_dll void eut::FileHelper::splitPath	(	const std::string &	rsFullFileName,
		std::string &	rsDrive,
		std::string &	rsPath,
		std::string &	rsFileName,
		std::string &	rsFileExtension )

Erwartet einen Dateinamen inkl.

Pfad (z.B. "c:/temp/TestText.txt"); liefert alle Pfadbestandteile.

Parameter

[in]

rsFullFileName

Der vollständige Dateiname des zu zerlegenden Dateinamens.

Zu beachten

Wenn nur ein Pfad ohne Datei übergeben werden soll, muss der Pfad mit einem '/' abschließen.

Parameter

[in,out]	rsDrive	Bezeichnung des Laufwerks (oder die Repräsentation eines solchens).
[in,out]	rsPath	Der Pfad. Als Pfadtrenner werden '/' geliefert.
[in,out]	rsFileName	Der Dateiname
[in,out]	rsFileExtension	Eine Dateierweiterung, wenn vorhanden.

splitPath() [2/2]

__tool_export_dll void eut::FileHelper::splitPath	(	const std::wstring &	rsFullFileName,
		std::wstring &	rsDrive,
		std::wstring &	rsPath,
		std::wstring &	rsFileName,
		std::wstring &	rsFileExtension )

Erwartet einen Dateinamen inkl.

Pfad (z.B. "c:/temp/TestText.txt"); liefert alle Pfadbestandteile.

Parameter

[in]

rsFullFileName

Der vollständige Dateiname des zu zerlegenden Dateinamens.

Zu beachten

Wenn nur ein Pfad ohne Datei übergeben werden soll, muss der Pfad mit einem '/' abschließen.

Parameter

[in,out]	rsDrive	Bezeichnung des Laufwerks (oder die Repräsentation eines solchens).
[in,out]	rsPath	Der Pfad. Als Pfadtrenner werden '/' geliefert.
[in,out]	rsFileName	Der Dateiname
[in,out]	rsFileExtension	Eine Dateierweiterung, wenn vorhanden.

storeFile() [1/7]

__tool_export_dll int eut::FileHelper::storeFile	(	char *	pszData,
		std::streamsize	nSize,
		const std::string &	rsFileName )

Speichert Daten in eine Datei im Filesystem.

Parameter

[in]	pszData	Zeiger auf den Speicher, welcher in einer Datei gespeichert werden soll.
[in]	nSize	Größe des zu speichernden Speichbereichs.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

storeFile() [2/7]

__tool_export_dll int eut::FileHelper::storeFile	(	char *	pszData,
		std::streamsize	nSize,
		const std::wstring &	rsFileName )

Speichert Daten in eine Datei im Filesystem.

Parameter

[in]	pszData	Zeiger auf den Speicher, welcher in einer Datei gespeichert werden soll.
[in]	nSize	Größe des zu speichernden Speichbereichs.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

storeFile() [3/7]

__tool_export_dll int eut::FileHelper::storeFile	(	const Blob &	rBlob,
		const std::string &	rsFileName )

Speichert den Inhalt eines Blobs in eine Datei im Filesystem.

Parameter

[in]	rBlob	Referenz auf ein Blob, desssen Inhalt in einer Datei gespeichert werden soll.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

storeFile() [4/7]

__tool_export_dll int eut::FileHelper::storeFile	(	const Blob &	rBlob,
		const std::wstring &	rsFileName )

Speichert den Inhalt eines Blobs in eine Datei im Filesystem.

Parameter

[in]	rBlob	Referenz auf ein Blob, desssen Inhalt in einer Datei gespeichert werden soll.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

storeFile() [5/7]

__tool_export_dll int eut::FileHelper::storeFile	(	const Blob *	pBlob,
		const std::string &	rsFileName )

Speichert den Inhalt eines Blobs in eine Datei im Filesystem.

Parameter

[in]	pBlob	Zeiger auf ein Blob, desssen Inhalt in einer Datei gespeichert werden soll.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

storeFile() [6/7]

__tool_export_dll int eut::FileHelper::storeFile	(	const Blob *	pBlob,
		const std::wstring &	rsFileName )

Speichert den Inhalt eines Blobs in eine Datei im Filesystem.

Parameter

[in]	pBlob	Zeiger auf ein Blob, desssen Inhalt in einer Datei gespeichert werden soll.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.

storeFile() [7/7]

__tool_export_dll int eut::FileHelper::storeFile	(	const std::string &	rsStr,
		const std::string &	rsFileName )

Speichert einen String in eine Datei im Filesystem.

Parameter

[in]	rsStr	Ein Standard-String, welcher in einer Datei gespeichert werden soll.
[in]	rsFileName	Der vollständige Dateiname (z.B. "c:\\temp\\TestText.txt").

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

swapDataInFile()

__tool_export_dll int eut::FileHelper::swapDataInFile	(	std::vector< std::string > &	rParamVector,
		bool	bSimulate = false )

Sucht und ersetzt Inhalte in Dateien und speichert diese ggf.

unter einem anderen Namen.

Parameter

[in]	rParamVector	Ein std::vector<std::string> mit den Parametern. Es werden folgende Parameter erwartet: rParamVector[0] Die Datei, deren Inhalt geändert werden soll (z.B. 'c:/dir/filename.txt'). rParamVector[1] Der Ausdruck, welcher in den Daten aus rParamVector[0] mit den Daten aus rParamVector[2] ausgetauscht werden soll. Format: Der Parameter rParamVector[1] muss immer mit 'text:' bzw. 't:', 'hex:' bzw. 'h:' oder 'file:' bzw. 'f:' beginnen. Wenn der Ausdruck mit 'text:' bzw. 't:' beginnt, wird der nachfolgende Text als auszutauschender Text genommen. Z.B. 'text:alter Text' ergibt'alter Text'. Wenn der Ausdruck mit 'hex:' bzw. 'h:' beginnt, wird der folgende Text nach 'hex:' bzw. 'h:' als Hexadezimalzahl-Folge interpretiert, der ausgetauscht werden soll. Die Hex-Werte müssen zweistellig, kommasepariert übergeben werden (z.B. "h:0D,0A"). Wenn der Ausdruck mit 'file:' bzw. 'f:' beginnt, wird der Inhalt aus der Datei genommen, deren Bezeichnung auf 'file:' bzw. 'f:' folgt. Wenn z.B. 'file:D:/dir/filename.txt', wird der Inhalt aus der Datei 'D:/dir/filename.txt' als auszutauschender Text genommen. rParamVector[2] Der auszutauschende Inhalt. Format: Der Parameter rParamVector[2] muss immer mit 'text:' bzw. 't:' oder 'file:' bzw. 'f:' beginnen. Wenn der Ausdruck mit 'text:' bzw. 't:' beginnt, wird der nachfolgende Text als neuer Text genommen. Z.B. 'text:neuer Text' ergibt'neuer Text' als neuen Text. Wenn der Ausdruck mit 'hex:' bzw. 'h:' beginnt, wird der urspruengliche Inhalt (der zweite Parameter 'AlterInhalt') durch die Hexadezimalzahl- Folge nach 'hex:' bzw. 'h:' ersetzt. Die Hex-Werte müssen zweistellig, kommasepariert übergeben werden (z.B. "h:0D,0A"). Wenn der Ausdruck mit 'file:' bzw. 'f:' beginnt, wird der Inhalt aus der Datei genommen, deren Bezeichnung auf 'file:' bzw. 'f:' folgt. Wenn z.B. 'file:D:/dir/filename.txt', wird der Inhalt aus der Datei 'D:/dir/filename.txt' als neuer Text genommen. rParamVector[3] Die Datei, in die der geänderte Inhalt aus rParamVector[0] gespeichert werden sollen. Wenn die zu speichernde Datei schon existiert, wird nicht überschrieben (Fehler ERR_FILE_ALREADY_EXIST). Siehe auch rParamVector[4-n] -> '-force'. Wenn der Parameter leer, wird in die Datei aus rParamVector[0] zurück gespeichert, der Parameter '-force' ist dafür nicht notwendig. rParamVector[4-n] Es kann ein Steuerbefehl übergeben werden: '-force' bzw. '-f' Es wird die Datei aus rParamVector[3] auch dann gespeichert, wenn diese schon existiert. '-cwd' Es wird die Zieldatei relativ zum aktuellen Arbeitsverzeichnis angelegt.
[in]	bSimulate	Wenn true, wird nicht gespeichert.

Zu beachten

Es wird in den Pfadangaben das Zeichen '/' als Trenner erwartet!

Rückgabe

Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten

Diese Funktion ist nur verfügbar, wenn die Präprozessor-Direktive __EUFILEHELPER_WITH_EUBLOB definiert ist.