KSCString.h 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
  1. //
  2. // KSCString.h
  3. //
  4. // Created by Karl Stenerud on 2013-02-23.
  5. //
  6. // Copyright (c) 2012 Karl Stenerud. All rights reserved.
  7. //
  8. // Permission is hereby granted, free of charge, to any person obtaining a copy
  9. // of this software and associated documentation files (the "Software"), to deal
  10. // in the Software without restriction, including without limitation the rights
  11. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12. // copies of the Software, and to permit persons to whom the Software is
  13. // furnished to do so, subject to the following conditions:
  14. //
  15. // The above copyright notice and this permission notice shall remain in place
  16. // in this source code.
  17. //
  18. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  24. // THE SOFTWARE.
  25. //
  26. #import <Foundation/Foundation.h>
  27. /**
  28. * A string, stored C style with null termination.
  29. */
  30. @interface KSCString : NSObject
  31. /** Length of the string in bytes (not characters!). Length does not include null terminator. */
  32. @property(nonatomic,readonly,assign) NSUInteger length;
  33. /** String contents, including null terminator */
  34. @property(nonatomic,readonly,assign) const char* bytes;
  35. /** Constructor for NSString */
  36. + (KSCString*) stringWithString:(NSString*) string;
  37. /** Constructor for null-terminated C string (assumes UTF-8 encoding). */
  38. + (KSCString*) stringWithCString:(const char*) string;
  39. /** Constructor for string contained in NSData (assumes UTF-8 encoding). */
  40. + (KSCString*) stringWithData:(NSData*) data;
  41. /** Constructor for non-terminated string (assumes UTF-8 encoding). */
  42. + (KSCString*) stringWithData:(const char*) data length:(NSUInteger) length;
  43. - (id) initWithString:(NSString*) string;
  44. - (id) initWithCString:(const char*) string;
  45. - (id) initWithData:(NSData*) data;
  46. - (id) initWithData:(const char*) data length:(NSUInteger) length;
  47. @end