-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathNSString-Methods.html
212 lines (198 loc) · 10.9 KB
/
NSString-Methods.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
<!-- HTML header for doxygen 1.8.6-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.6-nimbuskit"/>
<title>NimbusKit: NSString Methods</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
$(window).load(resizeHeight);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="appledocs.css" rel="stylesheet" type="text/css"/>
<link href="nimbuskit.css" rel="stylesheet" type="text/css" />
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-24278774-1']);
_gaq.push(['_setDomainName', 'nimbuskit.info']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<a href="index.html"><img style="float:left" src="nimbus128.png" width="80" height="80" /></a>
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">NimbusKit
 <span id="projectnumber">1.2.1 - <a href="http://github.com/jverkoey/nimbus">Fork Nimbus on Github</a> - <a href="http://wiki.nimbuskit.info/">Visit the Nimbus Wiki</a></span>
</div>
<div id="projectbrief">The iOS framework that grows only as fast as its documentation</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6-nimbuskit -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('NSString-Methods.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">NSString Methods<div class="ingroups"><a class="el" href="Foundation-Methods.html">Foundation Methods</a></div></div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gNIMD5HashFromString"><td class="memItemLeft" align="right" valign="top">NSString * </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNIMD5HashFromString">NIMD5HashFromString</a> (NSString *string)</td></tr>
<tr class="separator:gNIMD5HashFromString"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gNISHA1HashFromString"><td class="memItemLeft" align="right" valign="top">NSString * </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNISHA1HashFromString">NISHA1HashFromString</a> (NSString *string)</td></tr>
<tr class="separator:gNISHA1HashFromString"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gNIIsStringWithWhitespaceAndNewlines"><td class="memItemLeft" align="right" valign="top">BOOL </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNIIsStringWithWhitespaceAndNewlines">NIIsStringWithWhitespaceAndNewlines</a> (NSString *string)</td></tr>
<tr class="separator:gNIIsStringWithWhitespaceAndNewlines"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gNICompareVersionStrings"><td class="memItemLeft" align="right" valign="top">NSComparisonResult </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNICompareVersionStrings">NICompareVersionStrings</a> (NSString *string1, NSString *string2)</td></tr>
<tr class="separator:gNICompareVersionStrings"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gNIQueryDictionaryFromStringUsingEncoding"><td class="memItemLeft" align="right" valign="top">NSDictionary * </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNIQueryDictionaryFromStringUsingEncoding">NIQueryDictionaryFromStringUsingEncoding</a> (NSString *string, NSStringEncoding encoding)</td></tr>
<tr class="separator:gNIQueryDictionaryFromStringUsingEncoding"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gNIStringByAddingPercentEscapesForURLParameterString"><td class="memItemLeft" align="right" valign="top">NSString * </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNIStringByAddingPercentEscapesForURLParameterString">NIStringByAddingPercentEscapesForURLParameterString</a> (NSString *parameter)</td></tr>
<tr class="separator:gNIStringByAddingPercentEscapesForURLParameterString"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gNIStringByAddingQueryDictionaryToString"><td class="memItemLeft" align="right" valign="top">NSString * </td><td class="memItemRight" valign="bottom"><a class="el" href="NSString-Methods.html#gNIStringByAddingQueryDictionaryToString">NIStringByAddingQueryDictionaryToString</a> (NSString *string, NSDictionary *query)</td></tr>
<tr class="separator:gNIStringByAddingQueryDictionaryToString"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Overview</h2>
<p>For manipulating NSStrings. </p>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="gNIMD5HashFromString"></a>
<div class="memitem">
<h3 class="memname">NIMD5HashFromString</h3>
<div class="memdoc">
<p class="abstract">Calculates an md5 hash of the string using CC_MD5. </p>
<div class="declaration">
NSString* NIMD5HashFromString:(NSString *)string;</td></tr>
</div>
<h5>Discussion</h5>
<p>Treats the string as UTF8. </p>
</div>
</div>
<a class="anchor" id="gNISHA1HashFromString"></a>
<div class="memitem">
<h3 class="memname">NISHA1HashFromString</h3>
<div class="memdoc">
<p class="abstract">Calculates a sha1 hash of the string using CC_SHA1. </p>
<div class="declaration">
NSString* NISHA1HashFromString:(NSString *)string;</td></tr>
</div>
<h5>Discussion</h5>
<p>Treats the string as UTF8. </p>
</div>
</div>
<a class="anchor" id="gNIIsStringWithWhitespaceAndNewlines"></a>
<div class="memitem">
<h3 class="memname">NIIsStringWithWhitespaceAndNewlines</h3>
<div class="memdoc">
<p class="abstract">Returns a Boolean value indicating whether the string is a NSString object that contains only whitespace and newlines. </p>
<div class="declaration">
BOOL NIIsStringWithWhitespaceAndNewlines:(NSString *)string;</td></tr>
</div>
</div>
</div>
<a class="anchor" id="gNICompareVersionStrings"></a>
<div class="memitem">
<h3 class="memname">NICompareVersionStrings</h3>
<div class="memdoc">
<p class="abstract">Compares two strings expressing software versions. </p>
<div class="declaration">
NSComparisonResult NICompareVersionStrings;</td></tr>
</div>
<h5>Discussion</h5>
<p>The comparison is (except for the development version provisions noted below) lexicographic string comparison. So as long as the strings being compared use consistent version formats, a variety of schemes are supported. For example "3.02" < "3.03" and "3.0.2" < "3.0.3". If you mix such schemes, like trying to compare "3.02" and "3.0.3", the result may not be what you expect.</p>
<p>Development versions are also supported by adding an "a" character and more version info after it. For example "3.0a1" or "3.01a4". The way these are handled is as follows: if the parts before the "a" are different, the parts after the "a" are ignored. If the parts before the "a" are identical, the result of the comparison is the result of NUMERICALLY comparing the parts after the "a". If the part after the "a" is empty, it is treated as if it were "0". If one string has an "a" and the other does not (e.g. "3.0" and "3.0a1") the one without the "a" is newer.</p>
<p>Examples (?? means undefined):
<pre>
"3.0" = "3.0"
"3.0a2" = "3.0a2"
"3.0" > "2.5"
"3.1" > "3.0"
"3.0a1" < "3.0"
"3.0a1" < "3.0a4"
"3.0a2" < "3.0a19" <-- numeric, not lexicographic
"3.0a" < "3.0a1"
"3.02" < "3.03"
"3.0.2" < "3.0.3"
"3.00" ?? "3.0"
"3.02" ?? "3.0.3"
"3.02" ?? "3.0.2"
</pre>
</div>
</div>
<a class="anchor" id="gNIQueryDictionaryFromStringUsingEncoding"></a>
<div class="memitem">
<h3 class="memname">NIQueryDictionaryFromStringUsingEncoding</h3>
<div class="memdoc">
<p class="abstract">Parses a URL query string into a dictionary where the values are arrays. </p>
<div class="declaration">
NSDictionary* NIQueryDictionaryFromStringUsingEncoding;</td></tr>
</div>
<h5>Discussion</h5>
<p>A query string is one that looks like &param1=value1&param2=value2...</p>
<p>The resulting NSDictionary will contain keys for each parameter name present in the query. The value for each key will be an NSArray which may be empty if the key is simply present in the query. Otherwise each object in the array with be an NSString corresponding to a value in the query for that parameter. </p>
</div>
</div>
<a class="anchor" id="gNIStringByAddingPercentEscapesForURLParameterString"></a>
<div class="memitem">
<h3 class="memname">NIStringByAddingPercentEscapesForURLParameterString</h3>
<div class="memdoc">
<p class="abstract">Returns a string that has been escaped for use as a URL parameter. </p>
<div class="declaration">
NSString* NIStringByAddingPercentEscapesForURLParameterString:(NSString *)parameter;</td></tr>
</div>
</div>
</div>
<a class="anchor" id="gNIStringByAddingQueryDictionaryToString"></a>
<div class="memitem">
<h3 class="memname">NIStringByAddingQueryDictionaryToString</h3>
<div class="memdoc">
<p class="abstract">Appends a dictionary of query parameters to a string, adding the ? character if necessary. </p>
<div class="declaration">
NSString* NIStringByAddingQueryDictionaryToString;</td></tr>
</div>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.8.6-->
<!-- start footer part -->
<script type="text/javascript" src="widget.js"></script>
</body>
</html>