String.h File Reference

Immutable 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
	Immutable UTF-8 strings. More...

Typedefs
typedef wchar_t	Unicode
	The Unicode type. More...

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. More...

Detailed Description

Immutable 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 654 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 752 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;
}