mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-26 02:01:03 +00:00
6eef1c3289
* KVC Caching Implementation * Do not ignore struct name when comparing type encoding as NSPoint and NSSize have the same layout * Use fast-path when using Objective-C 2 * Guard old ValueForKey function when using the fast-path * Add basic NSKeyValueCoding tests * Update Copyright Years * NSKeyValueCoding+Caching: Add Versioning to IVar Slot * safe_caching: Remove Guards * Add type encoding helper header * Rename geometry structs (NSRect, NSPoint, NSSize) for toll-free bridging with CoreGraphics * Move CG struct definitions to CFCGTypes.h * Update known struct encoding prefixes * Windows 64-bit is LLP64 and not LP64 * Re-order to avoid complier warning --------- Co-authored-by: rfm <richardfrithmacdonald@gmail.com>
55 lines
No EOL
2.3 KiB
Objective-C
55 lines
No EOL
2.3 KiB
Objective-C
/** Key-Value Coding Safe Caching Support
|
|
Copyright (C) 2024 Free Software Foundation, Inc.
|
|
|
|
Written by: Hugo Melder <hugo@algoriddim.com>
|
|
Created: August 2024
|
|
|
|
This file is part of the GNUstep Base Library.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free
|
|
Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02110 USA.
|
|
*/
|
|
|
|
/**
|
|
* It turns out that valueForKey: is a very expensive operation, and a major
|
|
* bottleneck for Key-Value Observing and other operations such as sorting
|
|
* an array by key.
|
|
*
|
|
* The accessor search patterns for Key-Value observing are discussed in the
|
|
* Apple Key-Value Coding Programming Guide. The return value may be
|
|
* encapuslated into an NSNumber or NSValue object, depending on the Objective-C
|
|
* type encoding of the return value. This means that once valueForKey: found an
|
|
* existing accessor, the Objective-C type encoding of the accessor is
|
|
* retrieved. We then go through a huge switch case to determine the right way
|
|
* to invoke the IMP and potentially encapsulate the return type. The resulting
|
|
* object is then returned.
|
|
* The algorithm for setValue:ForKey: is similar.
|
|
*
|
|
* We can speed this up by caching the IMP of the accessor in a hash table.
|
|
* However, without proper versioning, this quickly becomes very dangerous.
|
|
* The user might exchange implementations, or add new ones expecting the
|
|
* search pattern invariant to still hold. If we clamp onto an IMP, this
|
|
* invariant no longer holds.
|
|
*
|
|
* We will make use of libobjc2's safe caching to avoid this.
|
|
*
|
|
* Note that the caching is opaque. You will only need to redirect all
|
|
* valueForKey: calls to the function below.
|
|
*/
|
|
|
|
#import "Foundation/NSString.h"
|
|
|
|
id
|
|
valueForKeyWithCaching(id obj, NSString *aKey); |