50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
+
+
+
+
+
+
+
+
+
+
+
+
|
*/
- (void)appendCharacters: (const OFUnichar *)characters length: (size_t)length;
/**
* @brief Appends a UTF-8 encoded C string to the OFMutableString.
*
* @param UTF8String A UTF-8 encoded C string to append
* @throw OFInvalidEncodingException The C string is not in not in the correct
* encoding
*/
- (void)appendUTF8String: (const char *)UTF8String;
/**
* @brief Appends a UTF-8 encoded C string with the specified length to the
* OFMutableString.
*
* @param UTF8String A UTF-8 encoded C string to append
* @param UTF8StringLength The length of the UTF-8 encoded C string
* @throw OFInvalidEncodingException The C string is not in not in the correct
* encoding
*/
- (void)appendUTF8String: (const char *)UTF8String
length: (size_t)UTF8StringLength;
/**
* @brief Appends a C string with the specified encoding to the OFMutableString.
*
* @param cString A C string to append
* @param encoding The encoding of the C string
* @throw OFInvalidEncodingException The C string is not in not in the correct
* encoding
*/
- (void)appendCString: (const char *)cString
encoding: (OFStringEncoding)encoding;
/**
* @brief Appends a C string with the specified encoding and length to the
* OFMutableString.
*
* @param cString A C string to append
* @param encoding The encoding of the C string
* @param cStringLength The length of the UTF-8 encoded C string
* @throw OFInvalidEncodingException The C string is not in not in the correct
* encoding
*/
- (void)appendCString: (const char *)cString
encoding: (OFStringEncoding)encoding
length: (size_t)cStringLength;
/**
* @brief Appends a formatted string to the OFMutableString.
*
* See `printf` for the format syntax. As an addition, `%@` is available as
* format specifier for objects, `%C` for `OFUnichar` and `%S` for
* `const OFUnichar *`.
*
* @param format A format string which generates the string to append
* @throw OFInvalidFormatException The specified format is invalid
* @throw OFInvalidEncodingException The resulting string is not in not in UTF-8
* encoding
*/
- (void)appendFormat: (OFConstantString *)format, ...;
/**
* @brief Appends a formatted string to the OFMutableString.
*
* See printf for the format syntax. As an addition, `%@` is available as
* format specifier for objects, `%C` for `OFUnichar` and `%S` for
* `const OFUnichar *`.
*
* @param format A format string which generates the string to append
* @param arguments The arguments used in the format string
* @throw OFInvalidFormatException The specified format is invalid
*/
- (void)appendFormat: (OFConstantString *)format arguments: (va_list)arguments;
/**
* @brief Converts the string to uppercase.
*/
- (void)uppercase;
|