libs-gsweb/GSWeb.framework/GSWUtils.h

/* utils.h - utils
   Copyright (C) 1999 Free Software Foundation, Inc.
   
   Written by:	Manuel Guesdon <mguesdon@sbuilders.com>
   Date: 		Jan 1999
   
   This file is part of the GNUstep Web Library.
   
   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
   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef _GSWebUtils_h__
#define _GSWebUtils_h__

#if defined(__FreeBSD__) || defined(__NetBSD__)
#include <sys/time.h>
#endif

#define CONST
#ifndef max
#define max(a,b) ((a) > (b) ? (a) : (b))
#endif
#ifndef min
#define min(a,b) ((a) < (b) ? (a) : (b))
#endif

#define IsStyle(__value,__style)			((((__value)&(__style))==(__style)) ? YES : NO)
#define IsNumberStyle(__value,__style)		(((([__value unsignedIntValue])&(__style))==(__style)) ? YES : NO)

#define VOID_RCSID	\
static void VoidUseRCSId() { rcsId[0]=0; };

#ifndef BYTE_DEFINED
typedef unsigned char BYTE;
#define BYTE_DEFINED
#endif
#ifndef UINTs_DEFINED
typedef unsigned int UINT;
typedef unsigned char UINT8;
typedef unsigned short UINT16;
typedef unsigned int UINT32;
#define UINTs_DEFINED
#endif

BOOL ClassIsKindOfClass(Class classA,Class classB);

void ExceptionRaiseFn(const char *func, 
					  const char *file,
					  int line,
					  NSString* name_,
					  NSString* format_,
					  ...);
void ExceptionRaiseFn0(const char *func, 
					   const char *file,
					   int line,
					   NSString* name_,
					   NSString* format_);

void ValidationExceptionRaiseFn(const char *func, 
								const char *file,
								int line,
								NSString* name_,
								NSString* message_,
								NSString* format_,
								...);
void ValidationExceptionRaiseFn0(const char *func, 
								 const char *file,
								 int line,
								 NSString* name_,
								 NSString* message_,
								 NSString* format_);

#define ExceptionRaise(name_, format_, args...)		\
  { ExceptionRaiseFn(__PRETTY_FUNCTION__, __FILE__, __LINE__,name_,format_, ## args); }

#define ExceptionRaise0(name_, format_)		\
  { ExceptionRaiseFn0(__PRETTY_FUNCTION__, __FILE__, __LINE__,name_,format_); }

#define ValidationExceptionRaise(name_,message_, format_, args...)		\
  { ValidationExceptionRaiseFn(__PRETTY_FUNCTION__, __FILE__, __LINE__,name_,message_,format_, ## args); }

#define ValidationExceptionRaise0(name_,message_, format_)		\
  { ValidationExceptionRaiseFn0(__PRETTY_FUNCTION__, __FILE__, __LINE__,name_,message_,format_); }

extern BOOL boolValueFor(id id_);
extern BOOL boolValueWithDefaultFor(id id_,BOOL default_);
//extern BOOLNB boolNbFor(BOOL value_);
extern BOOL isHeaderKeysEqual(NSString* headerKey,NSString* testKey);
extern BOOL SBIsEqual(id id1,id id2);
extern BOOL SBIsValueEqual(id id1,id id2);
extern BOOL SBIsValueIsIn(id id1,id id2);

extern id GetTmpName(NSString* dir,NSString* prefix);
extern NSTimeInterval NSTimeIntervalFromTimeVal(struct timeval* tv);
/* Basic data structure which holds all information we can get about a process.
 * (unless otherwise specified, fields are read from /proc/#/stat)
 */
typedef struct proc_s {
    char
        user[10],       /* user name corresponding to owner of process */
        cmd[40],        /* basename of executable file in call to exec(2) */
        state,          /* single-char code for process state (S=sleeping) */
        ttyc[5],        /* string representation of controlling tty device */
        **environ,      /* environment string vector (/proc/#/environ) */
        **cmdline;      /* command line string vector (/proc/#/cmdline) */
    int
        uid,            /* user id */
        pid,            /* process id */
        ppid,           /* pid of parent process */
        pgrp,           /* process group id */
        session,        /* session id */
        tty,            /* full device number of controlling terminal */
        tpgid,          /* terminal process group id */
        priority,       /* kernel scheduling priority */
        nice;           /* standard unix nice level of process */
    long long
        signal,         /* mask of pending signals */
        blocked,        /* mask of blocked signals */
        sigignore,      /* mask of ignored signals */
        sigcatch;       /* mask of caught  signals */
    long
        start_time,     /* start time of process -- seconds since 1-1-70 */
        utime,          /* user-mode CPU time accumulated by process */
        stime,          /* kernel-mode CPU time accumulated by process */
        cutime,         /* cumulative utime of process and reaped children */
        cstime,         /* cumulative stime of process and reaped children */
    /* the next 7 members come from /proc/#/statm */
        size,           /* total # of pages of memory */
        resident,       /* number of resident set (non-swapped) pages (4k) */
        share,          /* number of pages of shared (mmap'd) memory */
        trs,            /* text resident set size */
        lrs,            /* shared-lib resident set size */
        drs,            /* data resident set size */
        dt;             /* dirty pages */
    unsigned
        pcpu;           /* %CPU usage (is not filled in by readproc!!!) */
    unsigned long
        vsize,          /* number of pages of virtual memory ... */
        rss,            /* resident set size from /proc/#/stat */
        rss_rlim,       /* resident set size ... ? */
        timeout,        /* ? */
        it_real_value,  /* ? */
        flags,          /* kernel flags for the process */
        min_flt,        /* number of minor page faults since process start */
        maj_flt,        /* number of major page faults since process start */
        cmin_flt,       /* cumulative min_flt of process and child processes */
        cmaj_flt,       /* cumulative maj_flt of process and child processes */
        start_code,     /* address of beginning of code segment */
        end_code,       /* address of end of code segment */
        start_stack,    /* address of the bottom of stack for the process */
        kstk_esp,       /* kernel stack pointer */
        kstk_eip,       /* kernel stack pointer */
        wchan;          /* address of kernel wait channel proc is sleeping in */
    struct proc_s *l,   /* ptrs for building arbitrary linked structs */
                  *r;   /* (i.e. singly/doubly-linked lists and trees */
} proc_t;
extern void pidstat(pid_t pid, proc_t* P);
extern void pidstatm(pid_t pid, proc_t* P);



extern NSString* GSWGetDefaultDocRoot();
//To Move
extern NSString* DataToHexString(NSData* data);
extern NSData* HexStringToData(NSString* _string);

//====================================================================
@interface NSException (NSBuild)
+(NSException*)exceptionWithName:(NSString *)name
						  format:(NSString *)format,...;
@end


#define ExceptionByAddingUserInfoObjectFrameInfo(_exception,format_, args...)		\
[(_exception) exceptionByAddingUserInfoFrameInfoObject:self sel:_cmd file:__FILE__ line:__LINE__ format:format_, ## args]

#define ExceptionByAddingUserInfoObjectFrameInfo0(_exception,format_)		\
[(_exception) exceptionByAddingUserInfoFrameInfoObject:self sel:_cmd file:__FILE__ line:__LINE__ format:format_]

#define ExceptionByAddingUserInfoFunctionFrameInfo(format_, args...)		\
[(_exception) exceptionByAddingUserInfoFrameInfoFunction:__PRETTY_FUNCTION__ file:__FILE__ line:__LINE__ format:format_, ## args]

#define ExceptionByAddingUserInfoFunctionFrameInfo0(format_)		\
[(_exception) exceptionByAddingUserInfoFrameInfoFunction:__PRETTY_FUNCTION__ file:__FILE__ line:__LINE__ format:format_]

//====================================================================
@interface NSException (NSExceptionUserInfoAdd)

-(NSException*)exceptionByAddingUserInfo:(NSDictionary*)userInfo_;
-(NSException*)exceptionByAddingUserInfoKey:(id)key_
									 format:(NSString*)format_,...;
-(NSException*)exceptionByAddingToUserInfoKey:(id)key_
									 format:(NSString*)format_,...;
-(NSException*)exceptionByAddingUserInfoFrameInfo:(NSString*)frameInfo_;
-(NSException*)exceptionByAddingUserInfoFrameInfoFormat:(NSString*)format_,...;
-(NSException*)exceptionByAddingUserInfoFrameInfoObject:(id)obj_
													sel:(SEL)sel_
												   file:(const char*)file_
												   line:(int)line_
												 format:(NSString*)format_,...;
-(NSException*)exceptionByAddingUserInfoFrameInfoFunction:(const char*)fn_
													 file:(const char*)file_
													 line:(int)line_
												   format:(NSString*)format_,...;
-(BOOL)isValidationException;
@end

//====================================================================
@interface NSDate (NSDateHTMLDescription)
-(NSString*)htmlDescription;
@end

//====================================================================
@interface NSDictionary (SBDictionary)
-(id)		objectForKey:(id)_key
	   withDefaultObject:(id)_default;
+(id)	dictionaryWithDictionary:(NSDictionary*)dictionary_
 andDefaultEntriesFromDictionary:(NSDictionary*)dictionaryDefaults_;
-(id)dictionaryBySettingObject:(id)object_
						forKey:(id)key_;
-(id)dictionaryByAddingEntriesFromDictionary:(NSDictionary*)dictionary_;
@end

//====================================================================
@interface NSMutableDictionary (SBMutableDictionary)
-(void)setDefaultObject:(id)object_
				 forKey:(id)key_;
-(void)addDefaultEntriesFromDictionary:(NSDictionary*)dictionary_;
@end

//====================================================================
@interface NSMutableOrderedArray: NSMutableArray
{
  NSMutableArray *array;
  SEL compareSelector;
};
-(id)initWithCompareSelector:(SEL)compareSelector;
-(void)addObject:(id)object_;
-(void)addObjectsFromArray:(NSArray*)array_;
-(void)insertObject:(id)object_
			atIndex:(unsigned int)index_;
-(void)replaceObjectAtIndex:(unsigned int)index_
				 withObject:(id)object_;
-(void)replaceObjectsInRange:(NSRange)range_
		withObjectsFromArray:(NSArray*)array_;
-(void)replaceObjectsInRange:(NSRange)range_
		withObjectsFromArray:(NSArray*)array_
					   range:(NSRange)arrayRange_;
-(void)setArray:(NSArray*)array_;
@end

//====================================================================
@interface NSString (SBGoodPath)
-(NSString*)stringGoodPath;
@end

//====================================================================
@interface NSObject (NSObjectVoid)
-(id)nilMethod;
+(id)nilMethod;
-(NSString*)className;
+(NSString*)className;
-(id)performSelectorIfPossible:(SEL)aSelector;
-(id)performSelectorIfPossible:(SEL)aSelector
					withObject:(id)anObject;
-(id)performSelectorIfPossible:(SEL)aSelector
					withObject:(id)object1
					withObject:(id)object2;
@end

//====================================================================
@interface NSBundle (NSBundleAllFrameworks)
-(NSString*)bundleName;
@end

//====================================================================
#define TmpLock(_lock_)								[(_lock_) tmplockFromFunction:__PRETTY_FUNCTION__ file:__FILE__ line:__LINE__]
#define TmpTryLockBeforeDate(_lock_,_limit_)		[(_lock_) tmptryLockBeforeDate:(_limit_) fromFunction:__PRETTY_FUNCTION__ file:__FILE__ line:__LINE__]
#define TmpLockBeforeDate(_lock_,_limit_)			[(_lock_) tmplockBeforeDate:(_limit_) fromFunction:__PRETTY_FUNCTION__ file:__FILE__ line:__LINE__]
#define TmpUnlock(_lock_)							[(_lock_) tmpunlockFromFunction:__PRETTY_FUNCTION__ file:__FILE__ line:__LINE__]

//====================================================================
@interface NSLock (NSLockBD)
-(BOOL)isLocked;
-(BOOL)tmplock;
-(BOOL)tmplockFromFunction:(const char*)fn_
					  file:(const char*)file_
					  line:(int)line_;
-(BOOL)tmptryLock;
-(BOOL)tmptryLockFromFunction:(const char*)fn_
						 file:(const char*)file_
						 line:(int)line_;
-(BOOL)tmptryLockBeforeDate:(NSDate*)limit;
-(BOOL)tmptryLockBeforeDate:(NSDate*)limit
			   fromFunction:(const char*)fn_
					   file:(const char*)file_
					   line:(int)line_;
-(BOOL)tmplockBeforeDate:(NSDate*)limit;
-(BOOL)tmplockBeforeDate:(NSDate*)limit
			fromFunction:(const char*)fn_
					file:(const char*)file_
					line:(int)line_;
-(void)tmpunlock;
-(void)tmpunlockFromFunction:(const char*)fn_
						file:(const char*)file_
						line:(int)line_;
@end

//====================================================================
@interface NSRecursiveLock (NSLockBD)
-(BOOL)isLocked;
-(BOOL)tmplock;
-(BOOL)tmplockFromFunction:(const char*)fn_
					  file:(const char*)file_
					  line:(int)line_;
-(BOOL)tmptryLock;
-(BOOL)tmptryLockFromFunction:(const char*)fn_
						 file:(const char*)file_
						 line:(int)line_;
-(BOOL)tmptryLockBeforeDate:(NSDate*)limit;
-(BOOL)tmptryLockBeforeDate:(NSDate*)limit
			   fromFunction:(const char*)fn_
					   file:(const char*)file_
					   line:(int)line_;
-(BOOL)tmplockBeforeDate:(NSDate*)limit;
-(BOOL)tmplockBeforeDate:(NSDate*)limit
			fromFunction:(const char*)fn_
					file:(const char*)file_
					line:(int)line_;
-(void)tmpunlock;
-(void)tmpunlockFromFunction:(const char*)fn_
						file:(const char*)file_
						line:(int)line_;
@end

//====================================================================
@interface NSArray (NSPerformSelectorWith2Objects)
-(void)makeObjectsPerformSelector:(SEL)selector_
					   withObject:(id)object1_
					   withObject:(id)object2_;
-(void)makeObjectsPerformSelectorIfPossible:(SEL)aSelector;
-(void)makeObjectsPerformIfPossible:(SEL)aSelector;
-(void)makeObjectsPerformSelectorIfPossible:(SEL)aSelector
								 withObject:(id)argument;
-(void)makeObjectsPerformSelectorIfPossible:(SEL)aSelector
								 withObject:(id)argument1
								 withObject:(id)argument2;
-(void)makeObjectsPerformIfPossible:(SEL)aSelector
						 withObject:(id)argument;

@end

//====================================================================
@interface NSDictionary (NSPerformSelector)
-(void)makeObjectsPerformSelector:(SEL)selector_;
-(void)makeObjectsPerformSelector:(SEL)selector_
					   withObject:(id)object_;
-(void)makeObjectsPerformSelector:(SEL)selector_
					   withObject:(id)object1_
					   withObject:(id)object2_;
-(void)makeObjectsPerformSelectorIfPossible:(SEL)aSelector;
-(void)makeObjectsPerformIfPossible:(SEL)aSelector;
-(void)makeObjectsPerformSelectorIfPossible:(SEL)aSelector
								 withObject:(id)argument;
-(void)makeObjectsPerformSelectorIfPossible:(SEL)aSelector
								 withObject:(id)argument1
								 withObject:(id)argument2;
-(void)makeObjectsPerformIfPossible:(SEL)aSelector
						 withObject:(id)argument;
@end

//====================================================================
@interface NSDictionary (FromNSArray)
+(id)dictionaryWithArray:(NSArray*)array_
			  onSelector:(SEL)sel_;
+(id)dictionaryWithArray:(NSArray*)array_
			  onSelector:(SEL)sel_
			  withObject:(id)object;
@end

//====================================================================
@interface NSNumber (SBNumber)
+(NSNumber*)maxValueOf:(NSNumber*)_val0
				   and:(NSNumber*)_val1;
+(NSNumber*)minValueOf:(NSNumber*)_val0
				   and:(NSNumber*)_val1;
@end

//====================================================================
@interface NSData (SBNSData)
-(NSRange)rangeOfData:(NSData*)data;
-(NSRange)rangeOfData:(NSData*)data
			  options:(unsigned)mask;
-(NSRange)rangeOfData:(NSData *)aData
			  options:(unsigned)mask
				range:(NSRange)aRange;
-(NSArray*)componentsSeparatedByData:(NSData*)separator_;
-(NSData*)dataByDeletingFirstBytesCount:(unsigned int)bytesCount_;
-(NSData*)dataByDeletingLastBytesCount:(unsigned int)bytesCount_;
@end

//====================================================================
@interface NSMutableData (SBNSData)
-(void)deleteFirstBytesCount:(unsigned int)bytesCount_;
-(void)deleteLastBytesCount:(unsigned int)bytesCount_;
@end

//====================================================================
typedef enum _NSNumFmtType
{
  NSNumFmtType__Unknown	=	0,
  NSNumFmtType__Int		=	1,
  NSNumFmtType__Float	=	2,
} NSNumFmtType;

@interface NSFooNumberFormatter : NSFormatter <NSCoding, NSCopying>
{
  NSNumFmtType type;
};

-(id)initType:(NSNumFmtType)type_;
-(NSString*)stringForObjectValue:(id)anObject;
-(BOOL)getObjectValue:(id*)anObject
			forString:(NSString*)string
	 errorDescription:(NSString**)error;
@end

#endif // _GSWebUtils_h__