#include "Config.h"
#include <assert.h>
#include <iconv.h>
#include <stdarg.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <wchar.h>
#include "Hash.h"

Data Structures
struct	Transcode
	Character transcoding context for `iconv`. More...

Macros
#define	_Class _String

Functions
Class *	_String (void)

static void	appendBytes (String self, const uint8_t bytes, size_t length, StringEncoding encoding)

static void	appendCharacters (String self, const char chars)

static void	appendFormat (String self, const char fmt,...)

static void	appendString (String self, const String string)

static void	appendVaList (String self, const char fmt, va_list args)

static Order	compareTo (const String self, const String other, const Range range)

static Array *	componentsSeparatedByCharacters (const String self, const char chars)

static Array *	componentsSeparatedByString (const String self, const String string)

static Object *	copy (const Object *self)

static void	dealloc (Object *self)

static void	deleteCharactersInRange (String *self, const Range range)

static String *	description (const Object *self)

static Data *	getData (const String *self, StringEncoding encoding)

static int	hash (const Object *self)

static bool	hasPrefix (const String self, const String prefix)

static bool	hasSuffix (const String self, const String suffix)

static String *	init (String *self)

static void	initialize (Class *clazz)

static String *	initWithBytes (String self, const uint8_t bytes, size_t length, StringEncoding encoding)

static String *	initWithCapacity (String *self, size_t capacity)

static String *	initWithCharacters (String self, const char chars)

static String *	initWithContentsOfFile (String self, const char path, StringEncoding encoding)

static String *	initWithData (String self, const Data data, StringEncoding encoding)

static String *	initWithFormat (String self, const char fmt,...)

static String *	initWithMemory (String *self, const ident mem, size_t length)

static String *	initWithString (String self, const String string)

static String *	initWithVaList (String self, const char fmt, va_list args)

static void	insertCharactersAtIndex (String self, const char chars, size_t index)

static void	insertStringAtIndex (String self, const String string, size_t index)

static bool	isEqual (const Object self, const Object other)

static String *	lowercaseString (const String *self)

const char *	NameForStringEncoding (StringEncoding encoding)

static Range	rangeOfCharacters (const String self, const char chars, const Range range)

static Range	rangeOfString (const String self, const String string, const Range range)

static void	replaceCharactersInRange (String self, const Range range, const char chars)

static void	replaceOccurrencesOfCharacters (String self, const char chars, const char *replacement)

static void	replaceOccurrencesOfCharactersInRange (String self, const char chars, const Range range, const char *replacement)

static void	replaceOccurrencesOfString (String self, const String string, const String *replacement)

static void	replaceOccurrencesOfStringInRange (String self, const String string, const Range range, const String *replacement)

static void	replaceStringInRange (String self, const Range range, const String string)

static void	setCharacters (String self, const char chars)

static void	setFormat (String self, const char fmt,...)

static void	setLength (String *self, size_t length)

static void	setString (String self, const String string)

String *	str (const char *fmt,...)

static String *	string (void)

Order	StringCompare (const ident a, const ident b)

StringEncoding	StringEncodingForName (const char *name)

static String *	stringWithBytes (const uint8_t *bytes, size_t length, StringEncoding encoding)

static String *	stringWithCapacity (size_t capacity)

static String *	stringWithCharacters (const char *chars)

static String *	stringWithContentsOfFile (const char *path, StringEncoding encoding)

static String *	stringWithData (const Data *data, StringEncoding encoding)

static String *	stringWithFormat (const char *fmt,...)

static String *	stringWithMemory (const ident mem, size_t length)

char *	strtrim (const char *s)
	Copies the given null-terminated C string, trimming leading and trailing whitespace.

static String *	substring (const String *self, const Range range)

static size_t	transcode (Transcode *trans)
	Transcodes input from one character encoding to another via `iconv`.

static void	trim (String *self)

static String *	trimmedString (const String *self)

static String *	uppercaseString (const String *self)

static bool	writeToFile (const String self, const char path, StringEncoding encoding)

Macro Definition Documentation

◆ _Class

#define _Class _String

Definition at line 42 of file String.c.

Function Documentation

◆ _String()

Class * _String ( void )

Definition at line 994 of file String.c.

                     {
  static Class *clazz;
  static Once once;
 
  do_once(&once, {
    clazz = _initialize(&(const ClassDef) {
      .name = "String",
      .superclass = _Object(),
      .instanceSize = sizeof(String),
      .interfaceSize = sizeof(StringInterface),
      .initialize = initialize,
    });
  });
 
  return clazz;
}

◆ appendBytes()

static void appendBytes	(	String *	self,
		const uint8_t *	bytes,
		size_t	length,
		StringEncoding	encoding
	)

static

Definition at line 476 of file String.c.

                                                                                                    {
 
  if (bytes) {
 
    Transcode trans = {
      .to = STRING_ENCODING_UTF8,
      .from = encoding,
      .in = (char *) bytes,
      .length = length,
      .out = calloc(length * sizeof(Unicode) + 1, sizeof(char)),
      .size = length * sizeof(Unicode) + 1
    };
 
    assert(trans.out);
 
    const size_t size = transcode(&trans);
    assert(size < trans.size);
 
    trans.out[size] = '\0';
 
    $(self, appendCharacters, trans.out);
 
    free(trans.out);
  }
}

◆ appendCharacters()

static void appendCharacters	(	String *	self,
		const char *	chars
	)

static

Definition at line 506 of file String.c.

                                                              {
 
  if (chars) {
 
    const size_t len = strlen(chars);
    if (len) {
 
      const size_t newSize = self->length + strlen(chars) + 1;
      const size_t newCapacity = (newSize / _pageSize + 1) * _pageSize;
 
      if (newCapacity > self->capacity) {
 
        self->chars = realloc(self->chars, newCapacity);
        assert(self->chars);
        self->capacity = newCapacity;
      }
 
      ident ptr = self->chars + self->length;
      memmove(ptr, chars, len);
 
      self->chars[newSize - 1] = '\0';
      self->length += len;
    }
  }
}

◆ appendFormat()

static void appendFormat	(	String *	self,
		const char *	fmt,
			...
	)

static

Definition at line 536 of file String.c.

                                                             {
 
  va_list args;
  va_start(args, fmt);
 
  $(self, appendVaList, fmt, args);
 
  va_end(args);
}

◆ appendString()

static void appendString	(	String *	self,
		const String *	string
	)

static

Definition at line 550 of file String.c.

                                                             {
 
  if (string) {
    $(self, appendCharacters, string->chars);
  }
}

◆ appendVaList()

static void appendVaList	(	String *	self,
		const char *	fmt,
		va_list	args
	)

static

Definition at line 561 of file String.c.

                                                                      {
  char *chars;
 
  const int len = vasprintf(&chars, fmt, args);
  if (len > 0) {
    $(self, appendCharacters, chars);
  }
 
  free(chars);
}

◆ compareTo()

static Order compareTo	(	const String *	self,
		const String *	other,
		const Range	range
	)

static

Definition at line 161 of file String.c.

                                                                                   {
 
  assert(range.location + range.length <= self->length);
 
  if (other) {
    const int i = strncmp(self->chars + range.location, other->chars, range.length);
    if (i == 0) {
      return OrderSame;
    }
    if (i > 0) {
      return OrderDescending;
    }
  }
 
  return OrderAscending;
}

◆ componentsSeparatedByCharacters()

static Array * componentsSeparatedByCharacters	(	const String *	self,
		const char *	chars
	)

static

Definition at line 182 of file String.c.

                                                                                     {
 
  assert(chars);
 
  Array *components = $(alloc(Array), init);
 
  Range search = { 0, self->length };
  Range result = $(self, rangeOfCharacters, chars, search);
 
  while (result.length) {
    search.length = result.location - search.location;
 
    String *component = $(self, substring, search);
    $(components, addObject, component);
    release(component);
 
    search.location = result.location + result.length;
    search.length = self->length - search.location;
 
    result = $(self, rangeOfCharacters, chars, search);
  }
 
  String *component = $(self, substring, search);
  $(components, addObject, component);
  release(component);
 
  return components;
}

◆ componentsSeparatedByString()

static Array * componentsSeparatedByString	(	const String *	self,
		const String *	string
	)

static

Definition at line 215 of file String.c.

                                                                                    {
 
  assert(string);
 
  return $(self, componentsSeparatedByCharacters, string->chars);
}

◆ copy()

static Object * copy ( const Object * self )

static

See also: Object::copy(const Object *)

Definition at line 49 of file String.c.

                                        {
 
  const String *this = (const String *) self;
  String *that = $(alloc(String), initWithString, this);
 
  return (Object *) that;
}

◆ dealloc()

static void dealloc ( Object * self )

static

See also: Object::dealloc(Object *)

Definition at line 60 of file String.c.

                                  {
 
  String *this = (String *) self;
 
  free(this->chars);
 
  super(Object, self, dealloc);
}

◆ deleteCharactersInRange()

static void deleteCharactersInRange	(	String *	self,
		const Range	range
	)

static

Definition at line 576 of file String.c.

                                                                     {
 
  assert(range.location >= 0);
  assert(range.length <= self->length);
 
  ident ptr = self->chars + range.location;
  const size_t length = self->length - range.location - range.length + 1;
 
  memmove(ptr, ptr + range.length, length);
 
  self->length -= range.length;
}

◆ description()

static String * description ( const Object * self )

static

See also: Object::description(const Object *)

Definition at line 72 of file String.c.

                                               {
 
  return (String *) $((Object *) self, copy);
}

◆ getData()

static Data * getData	(	const String *	self,
		StringEncoding	encoding
	)

static

Definition at line 226 of file String.c.

                                                                  {
 
  Transcode trans = {
    .to = encoding,
    .from = STRING_ENCODING_UTF8,
    .in = self->chars,
    .length = self->length,
    .out = calloc(self->length, sizeof(Unicode) / sizeof(char)),
    .size = self->length * sizeof(Unicode)
  };
 
  assert(trans.out);
 
  const size_t size = transcode(&trans);
  assert(size <= trans.size);
 
  return $$(Data, dataWithMemory, trans.out, size);
}

◆ hash()

static int hash ( const Object * self )

static

See also: Object::hash(const Object *)

Definition at line 80 of file String.c.

                                    {
 
  String *this = (String *) self;
 
  return HashForCString(HASH_SEED, this->chars);
}

◆ hasPrefix()

static bool hasPrefix	(	const String *	self,
		const String *	prefix
	)

static

Definition at line 249 of file String.c.

                                                                {
 
  if (prefix->length > self->length) {
    return false;
  }
 
  Range range = { 0, prefix->length };
  return $(self, compareTo, prefix, range) == OrderSame;
}

◆ hasSuffix()

static bool hasSuffix	(	const String *	self,
		const String *	suffix
	)

static

Definition at line 263 of file String.c.

                                                                {
 
  if (suffix->length > self->length) {
    return false;
  }
 
  Range range = { self->length - suffix->length, suffix->length };
  return $(self, compareTo, suffix, range) == OrderSame;
}

◆ init()

static String * init ( String * self )

static

Definition at line 593 of file String.c.

                                  {
  return $(self, initWithCapacity, 0);
}

◆ initialize()

static void initialize ( Class * clazz )

static

See also: Class::initialize(Class *)

Definition at line 930 of file String.c.

                                     {
 
  ((ObjectInterface *) clazz->interface)->copy = copy;
  ((ObjectInterface *) clazz->interface)->dealloc = dealloc;
  ((ObjectInterface *) clazz->interface)->description = description;
  ((ObjectInterface *) clazz->interface)->hash = hash;
  ((ObjectInterface *) clazz->interface)->isEqual = isEqual;
 
  ((StringInterface *) clazz->interface)->compareTo = compareTo;
  ((StringInterface *) clazz->interface)->componentsSeparatedByCharacters = componentsSeparatedByCharacters;
  ((StringInterface *) clazz->interface)->componentsSeparatedByString = componentsSeparatedByString;
  ((StringInterface *) clazz->interface)->getData = getData;
  ((StringInterface *) clazz->interface)->hasPrefix = hasPrefix;
  ((StringInterface *) clazz->interface)->hasSuffix = hasSuffix;
  ((StringInterface *) clazz->interface)->initWithBytes = initWithBytes;
  ((StringInterface *) clazz->interface)->initWithCharacters = initWithCharacters;
  ((StringInterface *) clazz->interface)->initWithContentsOfFile = initWithContentsOfFile;
  ((StringInterface *) clazz->interface)->initWithData = initWithData;
  ((StringInterface *) clazz->interface)->initWithFormat = initWithFormat;
  ((StringInterface *) clazz->interface)->initWithMemory = initWithMemory;
  ((StringInterface *) clazz->interface)->initWithVaList = initWithVaList;
  ((StringInterface *) clazz->interface)->lowercaseString = lowercaseString;
  ((StringInterface *) clazz->interface)->appendBytes = appendBytes;
  ((StringInterface *) clazz->interface)->appendCharacters = appendCharacters;
  ((StringInterface *) clazz->interface)->appendFormat = appendFormat;
  ((StringInterface *) clazz->interface)->appendString = appendString;
  ((StringInterface *) clazz->interface)->appendVaList = appendVaList;
  ((StringInterface *) clazz->interface)->deleteCharactersInRange = deleteCharactersInRange;
  ((StringInterface *) clazz->interface)->init = init;
  ((StringInterface *) clazz->interface)->initWithCapacity = initWithCapacity;
  ((StringInterface *) clazz->interface)->initWithString = initWithString;
  ((StringInterface *) clazz->interface)->insertCharactersAtIndex = insertCharactersAtIndex;
  ((StringInterface *) clazz->interface)->insertStringAtIndex = insertStringAtIndex;
  ((StringInterface *) clazz->interface)->replaceCharactersInRange = replaceCharactersInRange;
  ((StringInterface *) clazz->interface)->replaceOccurrencesOfCharacters = replaceOccurrencesOfCharacters;
  ((StringInterface *) clazz->interface)->replaceOccurrencesOfCharactersInRange = replaceOccurrencesOfCharactersInRange;
  ((StringInterface *) clazz->interface)->replaceOccurrencesOfString = replaceOccurrencesOfString;
  ((StringInterface *) clazz->interface)->replaceOccurrencesOfStringInRange = replaceOccurrencesOfStringInRange;
  ((StringInterface *) clazz->interface)->replaceStringInRange = replaceStringInRange;
  ((StringInterface *) clazz->interface)->setCharacters = setCharacters;
  ((StringInterface *) clazz->interface)->setFormat = setFormat;
  ((StringInterface *) clazz->interface)->setLength = setLength;
  ((StringInterface *) clazz->interface)->setString = setString;
  ((StringInterface *) clazz->interface)->string = string;
  ((StringInterface *) clazz->interface)->stringWithCapacity = stringWithCapacity;
  ((StringInterface *) clazz->interface)->trim = trim;
  ((StringInterface *) clazz->interface)->rangeOfCharacters = rangeOfCharacters;
  ((StringInterface *) clazz->interface)->rangeOfString = rangeOfString;
  ((StringInterface *) clazz->interface)->stringWithBytes = stringWithBytes;
  ((StringInterface *) clazz->interface)->stringWithCharacters = stringWithCharacters;
  ((StringInterface *) clazz->interface)->stringWithContentsOfFile = stringWithContentsOfFile;
  ((StringInterface *) clazz->interface)->stringWithData = stringWithData;
  ((StringInterface *) clazz->interface)->stringWithFormat = stringWithFormat;
  ((StringInterface *) clazz->interface)->stringWithMemory = stringWithMemory;
  ((StringInterface *) clazz->interface)->substring = substring;
  ((StringInterface *) clazz->interface)->trimmedString = trimmedString;
  ((StringInterface *) clazz->interface)->uppercaseString = uppercaseString;
  ((StringInterface *) clazz->interface)->writeToFile = writeToFile;
}

◆ initWithBytes()

static String * initWithBytes	(	String *	self,
		const uint8_t *	bytes,
		size_t	length,
		StringEncoding	encoding
	)

static

Definition at line 601 of file String.c.

                                                                                                         {
 
  self = $(self, init);
  if (self) {
    $(self, appendBytes, bytes, length, encoding);
  }
 
  return self;
}

◆ initWithCapacity()

static String * initWithCapacity	(	String *	self,
		size_t	capacity
	)

static

Definition at line 615 of file String.c.

                                                               {
 
  self = $(self, initWithMemory, NULL, 0);
  if (self) {
    self->capacity = capacity;
    if (self->capacity) {
      self->chars = calloc(self->capacity, sizeof(char));
      assert(self->chars);
    }
  }
 
  return self;
}

◆ initWithCharacters()

static String * initWithCharacters	(	String *	self,
		const char *	chars
	)

static

Definition at line 633 of file String.c.

                                                                   {
 
  self = $(self, init);
  if (self) {
    $(self, appendCharacters, chars);
  }
 
  return self;
}

◆ initWithContentsOfFile()

static String * initWithContentsOfFile	(	String *	self,
		const char *	path,
		StringEncoding	encoding
	)

static

Definition at line 647 of file String.c.

                                                                                               {
 
  Data *data = $$(Data, dataWithContentsOfFile, path);
  if (data) {
    self = $(self, initWithData, data, encoding);
  } else {
    self = $(self, init);
  }
 
  release(data);
  return self;
}

◆ initWithData()

static String * initWithData	(	String *	self,
		const Data *	data,
		StringEncoding	encoding
	)

static

Definition at line 664 of file String.c.

                                                                                     {
 
  assert(data);
 
  return $(self, initWithBytes, data->bytes, data->length, encoding);
}

◆ initWithFormat()

static String * initWithFormat	(	String *	self,
		const char *	fmt,
			...
	)

static

Definition at line 675 of file String.c.

                                                                  {
 
  self = $(self, init);
  if (self) {
 
    va_list args;
    va_start(args, fmt);
 
    $(self, appendVaList, fmt, args);
 
    va_end(args);
  }
 
  return self;
}

◆ initWithMemory()

static String * initWithMemory	(	String *	self,
		const ident	mem,
		size_t	length
	)

static

Definition at line 695 of file String.c.

                                                                            {
 
  self = (String *) super(Object, self, init);
  if (self) {
    self->chars = (char *) mem;
    self->length = length;
    self->capacity = self->chars ? length + 1 : 0;
  }
 
  return self;
}

◆ initWithString()

static String * initWithString	(	String *	self,
		const String *	string
	)

static

Definition at line 711 of file String.c.

                                                                  {
 
  self = $(self, init);
  if (self) {
    $(self, appendString, string);
  }
 
  return self;
}

◆ initWithVaList()

static String * initWithVaList	(	String *	self,
		const char *	fmt,
		va_list	args
	)

static

Definition at line 725 of file String.c.

                                                                           {
 
  self = $(self, init);
  if (self) {
    $(self, appendVaList, fmt, args);
  }
 
  return self;
}

◆ insertCharactersAtIndex()

static void insertCharactersAtIndex	(	String *	self,
		const char *	chars,
		size_t	index
	)

static

Definition at line 739 of file String.c.

                                                                                   {
 
  const Range range = { .location = index };
 
  $(self, replaceCharactersInRange, range, chars);
}

◆ insertStringAtIndex()

static void insertStringAtIndex	(	String *	self,
		const String *	string,
		size_t	index
	)

static

Definition at line 750 of file String.c.

                                                                                  {
 
  $(self, insertCharactersAtIndex, string->chars, index);
}

◆ isEqual()

static bool isEqual	(	const Object *	self,
		const Object *	other
	)

static

See also: Object::isEqual(const Object *, const Object *)

Definition at line 90 of file String.c.

                                                             {
 
  if (super(Object, self, isEqual, other)) {
    return true;
  }
 
  if (other && $(other, isKindOfClass, _String())) {
 
    const String *this = (String *) self;
    const String *that = (String *) other;
 
    if (this->length == that->length) {
 
      const Range range = { 0, this->length };
      return $(this, compareTo, that, range) == OrderSame;
    }
  }
 
  return false;
}

◆ lowercaseString()

static String * lowercaseString ( const String * self )

static

Definition at line 281 of file String.c.

                                                   {
 
  Data *data = $(self, getData, STRING_ENCODING_WCHAR);
  assert(data);
 
  const size_t codepoints = data->length / sizeof(Unicode);
  Unicode *unicode = (Unicode *) data->bytes;
 
  for (size_t i = 0; i < codepoints; i++, unicode++) {
    *unicode = towlower(*unicode);
  }
 
  String *lowercase = $$(String, stringWithData, data, STRING_ENCODING_WCHAR);
 
  release(data);
  return lowercase;
}

◆ NameForStringEncoding()

const char * NameForStringEncoding ( StringEncoding encoding )

                                                           {
 
  switch (encoding) {
    case STRING_ENCODING_ASCII:
      return "ASCII";
    case STRING_ENCODING_LATIN1:
      return "ISO-8859-1";
    case STRING_ENCODING_LATIN2:
      return "ISO-8859-2";
    case STRING_ENCODING_MACROMAN:
      return "MacRoman";
    case STRING_ENCODING_UTF16:
      return "UTF-16";
    case STRING_ENCODING_UTF32:
      return "UTF-32";
    case STRING_ENCODING_UTF8:
      return "UTF-8";
    case STRING_ENCODING_WCHAR:
      return "WCHAR_T";
  }
 
  return "ASCII";
}

◆ rangeOfCharacters()

static Range rangeOfCharacters	(	const String *	self,
		const char *	chars,
		const Range	range
	)

static

Definition at line 303 of file String.c.

                                                                                         {
 
  assert(chars);
  assert(range.location > -1);
  assert(range.length > 0);
  assert(range.location + range.length <= self->length);
 
  Range match = { -1, 0 };
  const size_t len = strlen(chars);
 
  const char *str = self->chars + range.location;
  for (size_t i = 0; i < range.length; i++, str++) {
    if (strncmp(str, chars, len) == 0) {
      match.location = range.location + i;
      match.length = len;
      break;
    }
  }
 
  return match;
}

◆ rangeOfString()

static Range rangeOfString	(	const String *	self,
		const String *	string,
		const Range	range
	)

static

Definition at line 329 of file String.c.

                                                                                        {
 
  assert(string);
 
  return $(self, rangeOfCharacters, string->chars, range);
}

◆ replaceCharactersInRange()

static void replaceCharactersInRange	(	String *	self,
		const Range	range,
		const char *	chars
	)

static

Definition at line 759 of file String.c.

                                                                                         {
 
  assert(range.location >= 0);
  assert(range.location + range.length <= self->length);
 
  if (self->capacity == 0) {
    $(self, appendCharacters, chars);
  } else {
    char *remainder = strdup(self->chars + range.location + range.length);
 
    self->length = range.location;
    self->chars[range.location] = '\0';
 
    $(self, appendCharacters, chars);
    $(self, appendCharacters, remainder);
 
    free(remainder);
  }
}

◆ replaceOccurrencesOfCharacters()

static void replaceOccurrencesOfCharacters	(	String *	self,
		const char *	chars,
		const char *	replacement
	)

static

Definition at line 783 of file String.c.

                                                                                                     {
  $(self, replaceOccurrencesOfCharactersInRange, chars, (Range) { .length = self->length }, replacement);
}

◆ replaceOccurrencesOfCharactersInRange()

static void replaceOccurrencesOfCharactersInRange	(	String *	self,
		const char *	chars,
		const Range	range,
		const char *	replacement
	)

static

Definition at line 791 of file String.c.

                                                                                                                               {
 
  assert(chars);
  assert(replacement);
 
  assert(range.location >= 0);
  assert(range.location + range.length <= self->length);
 
  Range search = range;
  while (true) {
 
    const Range result = $((String *) self, rangeOfCharacters, chars, search);
    if (result.location == -1) {
      break;
    }
 
    $(self, replaceCharactersInRange, result, replacement);
 
    search.length -= (result.location - search.location);
    search.length -= strlen(replacement);
    search.length += ((int) strlen(replacement) - (int) strlen(chars));
 
    search.location = result.location + strlen(replacement);
  }
}

◆ replaceOccurrencesOfString()

static void replaceOccurrencesOfString	(	String *	self,
		const String *	string,
		const String *	replacement
	)

static

Definition at line 821 of file String.c.

                                                                                                      {
  $(self, replaceOccurrencesOfStringInRange, string, (Range) { .length = self->length }, replacement);
}

◆ replaceOccurrencesOfStringInRange()

static void replaceOccurrencesOfStringInRange	(	String *	self,
		const String *	string,
		const Range	range,
		const String *	replacement
	)

static

Definition at line 829 of file String.c.

                                                                                                                                {
 
  assert(string);
  assert(replacement);
 
  $(self, replaceOccurrencesOfCharactersInRange, string->chars, range, replacement->chars);
}

◆ replaceStringInRange()

static void replaceStringInRange	(	String *	self,
		const Range	range,
		const String *	string
	)

static

Definition at line 841 of file String.c.

                                                                                        {
 
  $(self, replaceCharactersInRange, range, string->chars);
}

◆ setCharacters()

static void setCharacters	(	String *	self,
		const char *	chars
	)

static

Definition at line 850 of file String.c.

                                                           {
 
  $(self, setLength, 0);
 
  $(self, appendCharacters, chars);
}

◆ setFormat()

static void setFormat	(	String *	self,
		const char *	fmt,
			...
	)

static

Definition at line 861 of file String.c.

                                                          {
 
  $(self, setLength, 0);
 
  va_list args;
  va_start(args, fmt);
 
  $(self, appendVaList, fmt, args);
 
  va_end(args);
}

◆ setLength()

static void setLength	(	String *	self,
		size_t	length
	)

static

Definition at line 877 of file String.c.

                                                   {
 
  if (length < self->length) {
    self->length = length;
    self->chars[length] = '\0';
  }
}

◆ setString()

static void setString	(	String *	self,
		const String *	string
	)

static

Definition at line 889 of file String.c.

                                                          {
 
  $(self, setLength, 0);
 
  $(self, appendString, string);
}

◆ str()

String * str	(	const char *	fmt,
			...
	)

                                  {
 
  va_list args;
  va_start(args, fmt);
 
  String *string = $(alloc(String), initWithVaList, fmt, args);
  assert(string);
 
  va_end(args);
 
  return string;
}

◆ string()

static String * string ( void )

static

Definition at line 900 of file String.c.

                            {
  return $(alloc(String), init);
}

◆ StringCompare()

Order StringCompare	(	const ident	a,
		const ident	b
	)

                                                  {
 
  if (a) {
    if (b) {
      const int i = strcmp(((String *) a)->chars, ((String *) b)->chars);
      if (i == 0) {
        return OrderSame;
      }
      if (i > 0) {
        return OrderDescending;
      }
    } else {
      return OrderDescending;
    }
  }
  return OrderAscending;
}

◆ StringEncodingForName()

StringEncoding StringEncodingForName ( const char * name )

                                                       {
 
  if (strcasecmp("ASCII", name) == 0) {
    return STRING_ENCODING_ASCII;
  } else if (strcasecmp("ISO-8859-1", name) == 0) {
    return STRING_ENCODING_LATIN1;
  } else if (strcasecmp("ISO-8859-2", name) == 0) {
    return STRING_ENCODING_LATIN2;
  } else if (strcasecmp("MacRoman", name) == 0) {
    return STRING_ENCODING_MACROMAN;
  } else if (strcasecmp("UTF-16", name) == 0) {
    return STRING_ENCODING_UTF16;
  } else if (strcasecmp("UTF-32", name) == 0) {
    return STRING_ENCODING_UTF32;
  } else if (strcasecmp("UTF-8", name) == 0) {
    return STRING_ENCODING_UTF8;
  } else if (strcasecmp("WCHAR", name) == 0) {
    return STRING_ENCODING_WCHAR;
  }
 
  return STRING_ENCODING_ASCII;
}

◆ stringWithBytes()

static String * stringWithBytes	(	const uint8_t *	bytes,
		size_t	length,
		StringEncoding	encoding
	)

static

Definition at line 340 of file String.c.

                                                                                             {
 
  return $(alloc(String), initWithBytes, bytes, length, encoding);
}

◆ stringWithCapacity()

static String * stringWithCapacity ( size_t capacity )

static

Definition at line 908 of file String.c.

                                                   {
  return $(alloc(String), initWithCapacity, capacity);
}

◆ stringWithCharacters()

static String * stringWithCharacters ( const char * chars )

static

Definition at line 349 of file String.c.

                                                       {
 
  return $(alloc(String), initWithCharacters, chars);
}

◆ stringWithContentsOfFile()

static String * stringWithContentsOfFile	(	const char *	path,
		StringEncoding	encoding
	)

static

Definition at line 358 of file String.c.

                                                                                   {
 
  return $(alloc(String), initWithContentsOfFile, path, encoding);
}

◆ stringWithData()

static String * stringWithData	(	const Data *	data,
		StringEncoding	encoding
	)

static

Definition at line 367 of file String.c.

                                                                         {
 
  return $(alloc(String), initWithData, data, encoding);
}

◆ stringWithFormat()

static String * stringWithFormat	(	const char *	fmt,
			...
	)

static

Definition at line 376 of file String.c.

                                                      {
 
  va_list args;
  va_start(args, fmt);
 
  String *string = $(alloc(String), initWithVaList, fmt, args);
 
  va_end(args);
 
  return string;
}

◆ stringWithMemory()

static String * stringWithMemory	(	const ident	mem,
		size_t	length
	)

static

Definition at line 392 of file String.c.

                                                                {
 
  return $(alloc(String), initWithMemory, mem, length);
}

◆ strtrim()

char * strtrim ( const char * s )

Copies the given null-terminated C string, trimming leading and trailing whitespace.

Parameters

s	A null-terminated C string.

Returns: A trimmed copy of str which must be freed by the caller.

Definition at line 1091 of file String.c.

                             {
 
  assert(s);
  while (isspace(*s)) {
    s++;
  }
 
  char *trimmed = strdup(s);
  assert(trimmed);
 
  char *end = trimmed + strlen(trimmed);
  if (end > trimmed) {
    while (isspace(*(--end))) {
      *end = '\0';
    }
  }
 
  return trimmed;
}

◆ substring()

static String * substring	(	const String *	self,
		const Range	range
	)

static

Definition at line 401 of file String.c.

                                                                {
 
  assert(range.location + range.length <= self->length);
 
  ident mem = calloc(range.length + 1, sizeof(char));
  assert(mem);
 
  strncpy(mem, self->chars + range.location, range.length);
 
  return $(alloc(String), initWithMemory, mem, range.length);
}

◆ transcode()

static size_t transcode ( Transcode * trans )

static

Transcodes input from one character encoding to another via iconv.

Parameters

trans A Transcode struct.

Returns: The number of bytes written to trans->out.

Definition at line 131 of file String.c.

                                          {
 
  assert(trans);
  assert(trans->to);
  assert(trans->from);
  assert(trans->out);
  assert(trans->size);
 
  iconv_t cd = iconv_open(NameForStringEncoding(trans->to), NameForStringEncoding(trans->from));
  assert(cd != (iconv_t) -1);
 
  char *in = trans->in;
  char *out = trans->out;
 
  size_t inBytesRemaining = trans->length;
  size_t outBytesRemaining = trans->size;
 
  const size_t ret = iconv(cd, &in, &inBytesRemaining, &out, &outBytesRemaining);
  assert(ret != (size_t) -1);
 
  int err = iconv_close(cd);
  assert(err == 0);
 
  return trans->size - outBytesRemaining;
}

◆ trim()

static void trim ( String * self )

static

Definition at line 916 of file String.c.

                               {
 
  String *trimmed = $((String *) self, trimmedString);
 
  $(self, replaceStringInRange, (const Range) { .length = self->length }, trimmed);
 
  release(trimmed);
}

◆ trimmedString()

static String * trimmedString ( const String * self )

static

Definition at line 417 of file String.c.

                                                 {
 
  Range range = { .location = 0, .length = self->length };
 
  while (isspace(self->chars[range.location])) {
    range.location++;
    range.length--;
  }
 
  while (range.length > 0 && isspace(self->chars[range.location + range.length - 1])) {
    range.length--;
  }
 
  return $(self, substring, range);
}

◆ uppercaseString()

static String * uppercaseString ( const String * self )

static

Definition at line 437 of file String.c.

                                                   {
 
  Data *data = $(self, getData, STRING_ENCODING_WCHAR);
  assert(data);
 
  const size_t codepoints = data->length / sizeof(Unicode);
  Unicode *unicode = (Unicode *) data->bytes;
 
  for (size_t i = 0; i < codepoints; i++, unicode++) {
    *unicode = towupper(*unicode);
  }
 
  String *uppercase = $$(String, stringWithData, data, STRING_ENCODING_WCHAR);
 
  release(data);
  return uppercase;
}

◆ writeToFile()

static bool writeToFile	(	const String *	self,
		const char *	path,
		StringEncoding	encoding
	)

static

Definition at line 459 of file String.c.

                                                                                       {
 
  Data *data = $(self, getData, encoding);
  assert(data);
 
  const bool success = $(data, writeToFile, path);
 
  release(data);
  return success;
}

Data Structures

Macros

Functions

Macro Definition Documentation

◆ _Class

Function Documentation

◆ _String()

◆ appendBytes()

◆ appendCharacters()

◆ appendFormat()

◆ appendString()

◆ appendVaList()

◆ compareTo()

◆ componentsSeparatedByCharacters()

◆ componentsSeparatedByString()

◆ copy()

◆ dealloc()

◆ deleteCharactersInRange()

◆ description()

◆ getData()

◆ hash()

◆ hasPrefix()

◆ hasSuffix()

◆ init()

◆ initialize()

◆ initWithBytes()

◆ initWithCapacity()

◆ initWithCharacters()

◆ initWithContentsOfFile()

◆ initWithData()

◆ initWithFormat()

◆ initWithMemory()

◆ initWithString()

◆ initWithVaList()

◆ insertCharactersAtIndex()

◆ insertStringAtIndex()

◆ isEqual()

◆ lowercaseString()

◆ NameForStringEncoding()

◆ rangeOfCharacters()

◆ rangeOfString()

◆ replaceCharactersInRange()

◆ replaceOccurrencesOfCharacters()

◆ replaceOccurrencesOfCharactersInRange()

◆ replaceOccurrencesOfString()

◆ replaceOccurrencesOfStringInRange()

◆ replaceStringInRange()

◆ setCharacters()

◆ setFormat()

◆ setLength()

◆ setString()

◆ str()

◆ string()

◆ StringCompare()

◆ StringEncodingForName()

◆ stringWithBytes()

◆ stringWithCapacity()

◆ stringWithCharacters()

◆ stringWithContentsOfFile()

◆ stringWithData()

◆ stringWithFormat()

◆ stringWithMemory()

◆ strtrim()

◆ substring()

◆ transcode()

◆ trim()

◆ trimmedString()

◆ uppercaseString()

◆ writeToFile()