aboutsummaryrefslogtreecommitdiff
path: root/Foundation/GTMNSString+URLArguments.h
diff options
context:
space:
mode:
Diffstat (limited to 'Foundation/GTMNSString+URLArguments.h')
-rw-r--r--Foundation/GTMNSString+URLArguments.h8
1 files changed, 6 insertions, 2 deletions
diff --git a/Foundation/GTMNSString+URLArguments.h b/Foundation/GTMNSString+URLArguments.h
index d4c7e09..b3a3e3e 100644
--- a/Foundation/GTMNSString+URLArguments.h
+++ b/Foundation/GTMNSString+URLArguments.h
@@ -22,7 +22,7 @@
@interface NSString (GTMNSStringURLArgumentsAdditions)
/// Returns a string that is escaped properly to be a URL argument.
-//
+///
/// This differs from stringByAddingPercentEscapesUsingEncoding: in that it
/// will escape all the reserved characters (per RFC 3986
/// <http://www.ietf.org/rfc/rfc3986.txt>) which
@@ -30,10 +30,14 @@
///
/// This will also escape '%', so this should not be used on a string that has
/// already been escaped unless double-escaping is the desired result.
+///
+/// NOTE: Apps targeting iOS 8 or OS X 10.10 and later should use
+/// NSURLComponents and NSURLQueryItem to create properly-escaped
+/// URLs instead of using these category methods.
- (NSString*)gtm_stringByEscapingForURLArgument;
/// Returns the unescaped version of a URL argument
-//
+///
/// This has the same behavior as stringByReplacingPercentEscapesUsingEncoding:,
/// except that it will also convert '+' to space.
- (NSString*)gtm_stringByUnescapingFromURLArgument;