String.h File Reference

UTF-8 strings. More...

#include <ctype.h>
#include <wctype.h>
#include <stdarg.h>
#include <Objectively/Array.h>
#include <Objectively/Data.h>

Go to the source code of this file.

Data Structures
struct	String
	UTF-8 strings. More...

Typedefs
typedef wchar_t	Unicode
	The Unicode type.

Enumerations
enum	StringEncoding {   STRING_ENCODING_ASCII = 1 , STRING_ENCODING_LATIN1 , STRING_ENCODING_LATIN2 , STRING_ENCODING_MACROMAN ,   STRING_ENCODING_UTF16 , STRING_ENCODING_UTF32 , STRING_ENCODING_UTF8 , STRING_ENCODING_WCHAR }
	Character encodings for Strings. More...

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

Detailed Description

UTF-8 strings.

Definition in file String.h.

Typedef Documentation

Unicode

typedef wchar_t Unicode

The Unicode type.

Definition at line 41 of file String.h.

Enumeration Type Documentation

StringEncoding

enum StringEncoding

Character encodings for Strings.

Enumerator
STRING_ENCODING_ASCII
STRING_ENCODING_LATIN1
STRING_ENCODING_LATIN2
STRING_ENCODING_MACROMAN
STRING_ENCODING_UTF16
STRING_ENCODING_UTF32
STRING_ENCODING_UTF8
STRING_ENCODING_WCHAR

Definition at line 46 of file String.h.

             {
  STRING_ENCODING_ASCII = 1,
  STRING_ENCODING_LATIN1,
  STRING_ENCODING_LATIN2,
  STRING_ENCODING_MACROMAN,
  STRING_ENCODING_UTF16,
  STRING_ENCODING_UTF32,
  STRING_ENCODING_UTF8,
  STRING_ENCODING_WCHAR,
} StringEncoding;

Function Documentation

_String()

OBJECTIVELY_EXPORT Class * _String

(

void

)

Definition at line 999 of file String.c.

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

strtrim()

OBJECTIVELY_EXPORT 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 1097 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;
}