Create ObjCCast<>() and ObjCCastStrict<>() methods

base/mac/foundation_util.h

Index: base/mac/foundation_util.h
diff --git a/base/mac/foundation_util.h b/base/mac/foundation_util.h
index 4c4abc69dbade923e49adf927d49fe3dcc4721e4..5c0225e29e2a5c29de0106815726ffe971a94830 100644
--- a/base/mac/foundation_util.h
+++ b/base/mac/foundation_util.h
@@ -224,6 +224,48 @@ T CFCast(const CFTypeRef& cf_val);
 BASE_EXPORT template<class T>
 T CFCastStrict(const CFTypeRef& cf_val);
 
+#if defined(__OBJC__)
+
+// ObjCCast<>() and ObjCCastStrict<>() cast a basic id to a more
+// specific (NSObject-derived) type. The compatibility of the passed
+// object is found by checking if it's a kind of the requested type
+// identifier. If the supplied object is not compatible with the
+// requested return type, ObjCCast<>() returns nil and
+// ObjCCastStrict<>() will DCHECK. Providing a nil pointer to either
+// variant results in nil being returned without triggering any DCHECK.
+//
+// The strict variant is useful when retrieving a value that you
+// stuffed into a collection, where you know you’ve only stuffed

[Mark Mentovai, 2011/10/23 16:05:24]

Your copy-and-paste job of my e-mail has resulted in non-ASCII characters
appearing here. This one’s a curly right single quote, and I see more on lines
242 and 244. We don’t check non-ASCII source in.

+// values of a specific type. For example, an NSArray of NSStrings.
+// The non-strict variant is handy when retrieving values from data
+// that aren't fully controlled yourself. For example, a plist read

[Mark Mentovai, 2011/10/23 16:05:24]

“data that aren’t fully controlled yourself” is nonsense—the “yourself” doesn’t
really refer to anything.

+// from disk may be beyond your exclusive control, so you’d merely
+// want to check that the values you retrieve from it are of the expected
+// types, but not crash if they’re not.
+//
+// Example usage:
+// NSString* version = base::mac::ObjCCast<NSString>(
+//     [bundle objectForInfoDictionaryKey:@"CFBundleShortVersionString"]);
+//
+// NSString* str = base::mac::ObjCCastStrict<NSString>(
+//     [ns_arr_of_ns_strs objectAtIndex:0]);
+BASE_EXPORT template<class T>
+T* ObjCCast(id objc_val) {
+  if ([objc_val isKindOfClass:[T class]]) {
+    return reinterpret_cast<T*>(objc_val);
+  }
+  return nil;
+}
+
+BASE_EXPORT template<class T>
+T* ObjCCastStrict(id objc_val) {
+  T* rv = ObjCCast<T>(objc_val);
+  DCHECK(objc_val == nil || rv);
+  return rv;
+}
+
+#endif  // defined(__OBJC__)
+
 }  // namespace mac
 }  // namespace base