---
title: "unarchiveObject(withFile:)"
framework: foundation
role: symbol
role_heading: Type Method
path: "foundation/nskeyedunarchiver/unarchiveobject(withfile:)"
---

# unarchiveObject(withFile:)

Decodes and returns the object graph previously encoded by NSKeyedArchiver written to the file at a given path.

## Declaration

```swift
class func unarchiveObject(withFile path: String) -> Any?
```

## Parameters

- `path`: A path to a file that contains an object graph previously encoded by NSKeyedArchiver.

## Return Value

Return Value The object graph previously encoded by NSKeyedArchiver written to the file path. Returns nil if there is no file at path.

## Discussion

Discussion This method raises an invalidArgumentException if the file at path does not contain a valid archive.

## See Also

### Unarchiving Data

- [unarchiveTopLevelObjectWithData(_:)](foundation/nskeyedunarchiver/unarchivetoplevelobjectwithdata(_:).md)
- [unarchivedObject(ofClass:from:)](foundation/nskeyedunarchiver/unarchivedobject(ofclass:from:).md)
- [unarchivedObject(ofClasses:from:)](foundation/nskeyedunarchiver/unarchivedobject(ofclasses:from:)-b9t5.md)
- [unarchivedObject(ofClasses:from:)](foundation/nskeyedunarchiver/unarchivedobject(ofclasses:from:)-3h32t.md)
- [requiresSecureCoding](foundation/nskeyedunarchiver/requiressecurecoding.md)
- [unarchiveObject(with:)](foundation/nskeyedunarchiver/unarchiveobject(with:).md)