text: //
  //  NSString+OTPURLArguments.h
  //
  //  Copyright 2006-2011 Google Inc.
  //
  //  Licensed under the Apache License, Version 2.0 (the "License"); you may not
  //  use this file except in compliance with the License.  You may obtain a copy
  //  of the License at
  // 
  //  http://www.apache.org/licenses/LICENSE-2.0
  // 
  //  Unless required by applicable law or agreed to in writing, software
  //  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  //  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
  //  License for the specific language governing permissions and limitations under
  //  the License.
  //
  
  #import <Foundation/Foundation.h>
  
  /// Utilities for encoding and decoding URL arguments.
  @interface NSString (OTPURLArguments)
  
  /// 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
  /// stringByAddingPercentEscapesUsingEncoding would leave.
  ///
  /// 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.
  - (NSString*)otp_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*)otp_stringByUnescapingFromURLArgument;
  
  @end
  