<!--
{
  "availability" : [
    "iOS: 2.0.0 - 2.0.0",
    "iPadOS: 2.0.0 - 2.0.0",
    "tvOS: 9.0.0 - 9.0.0",
    "visionOS: 1.0.0 - 1.0.0",
    "watchOS: 2.0.0 - 2.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "ObjectiveC",
  "identifier" : "/documentation/ObjectiveC/NSObject-swift.class/storedValue(forKey:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Objective-C Runtime",
      "ObjectiveC"
    ],
    "preciseIdentifier" : "c:objc(cs)NSObject(im)storedValueForKey:"
  },
  "title" : "storedValue(forKey:)"
}
-->

# storedValue(forKey:)

Returns the property identified by a given key.

```
func storedValue(forKey key: String) -> Any?
```

## Discussion

This method is used when the value is retrieved for storage in an object store (generally, this storage is ultimately in a database) or for inclusion in a snapshot. The default implementation is similar to the implementation of [`value(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/value(forKey:)), but it resolves `key` with a different method/instance variable search order:

1. Searches for a private accessor method based on `key` (a method preceded by an underbar). For example, with a `key` of “lastName”, [`storedValue(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/storedValue(forKey:)) looks for a method named `_getLastName` or `_lastName`.
2. If a private accessor is not found, searches for an instance variable based on `key` and returns its value directly. For example, with a `key` of “lastName”, [`storedValue(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/storedValue(forKey:)) looks for an instance variable named `_lastName` or `lastName`.
3. If neither a private accessor nor an instance variable is found, [`storedValue(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/storedValue(forKey:)) searches for a public accessor method based on `key`. For the `key` “lastName”, this would be `getLastName` or `lastName`.
4. If `key` is unknown, [`storedValue(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/storedValue(forKey:)) calls [`handleTakeValue(_:forUnboundKey:)`](/documentation/ObjectiveC/NSObject-swift.class/handleTakeValue(_:forUnboundKey:)).

This different search order allows an object to bypass processing that is performed before returning a value through a public API. However, if you always want to use the search order in [`value(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/value(forKey:)), you can implement the class method [`useStoredAccessor()`](/documentation/ObjectiveC/NSObject-swift.class/useStoredAccessor()) to return [`NO`](/documentation/ObjectiveC/NO). And as with [`value(forKey:)`](/documentation/ObjectiveC/NSObject-swift.class/value(forKey:)), you can prevent direct access of an instance variable with the class method [`accessInstanceVariablesDirectly`](/documentation/ObjectiveC/NSObject-swift.class/accessInstanceVariablesDirectly).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)