aboutsummaryrefslogtreecommitdiff
path: root/Foundation/GTMNSDictionary+CaseInsensitive.h
blob: a31e81ce14d190d71cfcac09675365c30e3a11c0 (plain)
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
//
//  GTMNSDictionary+CaseInsensitive.h
//
//  Copyright 2009 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>

/// Utility for building case-insensitive NSDictionary objects.
@interface NSDictionary (GTMNSDictionaryCaseInsensitiveAdditions)

/// Initializes an NSDictionary with a case-insensitive comparison function
/// for NSString keys, while non-NSString keys are treated normally.
///
/// The case for NSString keys is preserved, though duplicate keys (when
/// compared in a case-insensitive fashion) have one of their values dropped
/// arbitrarily.
///
/// An example of use with HTTP headers in an NSHTTPURLResponse object:
///
/// NSDictionary *headers =
///     [NSDictionary gtm_dictionaryWithDictionaryCaseInsensitive:
///      [response allHeaderFields]];
/// NSString *contentType = [headers objectForKey:@"Content-Type"];
- (id)gtm_initWithDictionaryCaseInsensitive:(NSDictionary *)dictionary;

/// Returns a newly created and autoreleased NSDictionary object as above.
+ (id)gtm_dictionaryWithDictionaryCaseInsensitive:(NSDictionary *)dictionary;

@end