//
// G A M E.O.N.E - LOW LEVEL LIB V1.0
// Copyright (C) 2001 LEVEL ONE ENTERTAINMENT, 
// Licensed under the terms of LGPL.
//:---------------------------------------------------------------------------
//:Description
//
// FRAMEWORK util.h
//
//

#ifndef _LLFRM_UTIL_H
#define _LLFRM_UTIL_H

#define MAXSTRINGLEN (1024)


/*
 *	Liefert neue Länge
 *	return 0     bei Fehler, oder bei Leeren string
 *         >0    Anzahl der Zeichen bis Whitspace gefunden wurde
 */
int RemoveWhiteSpaceAtTail(char *buf, int bufsize=256 );

/*
 *	Wenn der Delimiter 0 ist, wird der String ab buf bis zur nächsten 0x00
 *  nach target kopiert.
 *  Defaultlänge ist 255 Zeichen.
 *	Wenn delimiter ungleich 0 ist, dann wird bis zum ersten Delimiter ignoriert,
 *	Erst dann wird bis zum zweiten Delimiter übertragen.
 *	Returnwert ist der buf Zeiger für den nächsten Substring Aufruf
 *  Returnwert NULL bei Fehler
 */
char * GetSubstring(char * buf, char * target, char delimiter='\n', int targetsize=256 );
char * GetFirststring(char * buf, char * target, char delimiter='\n', int targetsize=256 );

/*
 *	Parse Arg2
 *	Liefert Zeichenkette vom zweiten Argument das in Anführungszeichen stehen darf.
 *	Nach "target" wird nur die die Zeichenkette ohne Anführungszeichen gestellt.
 *	Returnwert ist der Zeiger auf target buffer
 */
char * ParseArg2(char *buf, char *target, int targetsize=256 );

/*
 *	ReplaceChar tauscht ein Zeichen aus
 *  buf zeigt auf die Zeichenkette
 *  maxlen = 0 bedeutet bis zur ersten 0 die innerhalb 256 Zeichen auftregen muss sonst exception
 *  maxlen > 0 bedeutet das die erste 0 ignoriert wird und bis maxlen die Zeichen ausgetauscht werden
 */
char * ReplaceChar( char * buf, char oldchar, char newchar, int maxlen=0 );



#endif // if _LLFRM_UTIL_H