err.no Git - sope/blob - sope-core/NGExtensions/NGExtensions/NSString+Formatting.h

   1 /*
   2   Copyright (C) 2000-2005 SKYRIX Software AG
   3
   4   This file is part of SOPE.
   5
   6   SOPE is free software; you can redistribute it and/or modify it under
   7   the terms of the GNU Lesser General Public License as published by the
   8   Free Software Foundation; either version 2, or (at your option) any
   9   later version.
  10
  11   SOPE is distributed in the hope that it will be useful, but WITHOUT ANY
  12   WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
  14   License for more details.
  15
  16   You should have received a copy of the GNU Lesser General Public
  17   License along with SOPE; see the file COPYING.  If not, write to the
  18   Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  19   02111-1307, USA.
  20 */
  21
  22 #ifndef __NGExtensions_NSString_Formatting_H__
  23 #define __NGExtensions_NSString_Formatting_H__
  24
  25 #import <Foundation/NSString.h>
  26
  27 // category
  28
  29 @interface NSString(XSFormatting)
  30
  31 + (id)stringWithCFormat:(const char *)_format arguments:(va_list)_ap;
  32 + (id)stringWithCFormat:(const char *)_format, ...;
  33
  34 @end
  35
  36 @interface NSMutableString(XSFormatting)
  37
  38 - (void)appendFormat:(NSString *)_format arguments:(va_list)_ap;
  39 - (void)appendFormat:(NSString *)_format, ...;
  40
  41 @end
  42
  43 // C support functions
  44
  45 static inline int
  46 xs_vsnprintf(char *str, size_t max, const char *fmt, va_list _ap)
  47 {
  48   NSString *obj = [NSString stringWithCFormat:str arguments:_ap];
  49   [obj getCString:str maxLength:(max - 1)];
  50   return [obj cStringLength]; // return the len the string would have consumed
  51 }
  52
  53 static inline int xs_vsprintf (char *_str, const char *_fmt, va_list _ap) {
  54   NSString *obj = [NSString stringWithCFormat:_str arguments:_ap];
  55   [obj getCString:_str];
  56   return [obj cStringLength]; // return the length of the string
  57 }
  58
  59 /*
  60   Could use formats ..
  61      //     __attribute__ ((format (printf, 2, 3)));
  62      //     __attribute__ ((format (printf, 3, 4)));
  63 */
  64 int xs_sprintf (char *str, const char *format, ...);
  65 int xs_snprintf(char *str, size_t size, const char *format, ...);
  66
  67 #endif /* __NGExtensions_NSString_Formatting_H__ */