diff options
Diffstat (limited to 'WebCore/platform/mac/FoundationExtras.h')
-rw-r--r-- | WebCore/platform/mac/FoundationExtras.h | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/WebCore/platform/mac/FoundationExtras.h b/WebCore/platform/mac/FoundationExtras.h new file mode 100644 index 0000000..51a7df0 --- /dev/null +++ b/WebCore/platform/mac/FoundationExtras.h @@ -0,0 +1,72 @@ +/* + * Copyright (C) 2004 Apple Computer, Inc. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY + * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY + * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +// nil-checked CFRetain/CFRelease covers for Objective-C ids + +// Use CFRetain, CFRelease, HardRetain, or HardRelease instead of +// -[NSObject retain] and -[NSObject release] if you want to store +// a pointer to an Objective-C object into memory that won't +// be scanned for GC, like a C++ object. + +static inline id HardRetain(id obj) +{ + if (obj) CFRetain(obj); + return obj; +} + +static inline void HardRelease(id obj) +{ + if (obj) CFRelease(obj); +} + +// As if CF and Foundation had logically separate reference counts, +// this function first increments the CF retain count, and then +// decrements the NS retain count. This is needed to handle cases where +// -retain/-release aren't equivalent to CFRetain/HardRelease, such as +// when GC is used. + +// Use HardRetainWithNSRelease after allocating and initializing a NSObject +// if you want to store a pointer to that object into memory that won't +// be scanned for GC, like a C++ object. + +static inline id HardRetainWithNSRelease(id obj) +{ + HardRetain(obj); + [obj release]; + return obj; +} + +// Use HardAutorelease to return an object made by a CoreFoundation +// "create" or "copy" function as an autoreleased and garbage collected +// object. CF objects need to be "made collectable" for autorelease to work +// properly under GC. + +static inline id HardAutorelease(CFTypeRef obj) +{ + if (obj) + CFMakeCollectable(obj); + [(id)obj autorelease]; + return (id)obj; +} |