<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BackgroundAssets",
  "identifier" : "/documentation/BackgroundAssets/AssetPackManager/contents(at:searchingInAssetPackWithID:options:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Background Assets"
    ],
    "preciseIdentifier" : "s:16BackgroundAssets16AssetPackManagerC8contents2at011searchingIncD6WithID7options10Foundation4DataV6System8FilePathV_SSSgSo20NSDataReadingOptionsVtKF"
  },
  "title" : "contents(at:searchingInAssetPackWithID:options:)"
}
-->

# contents(at:searchingInAssetPackWithID:options:)

Returns the contents of an asset file at the specified relative path.

```
nonisolated func contents(at path: FilePath, searchingInAssetPackWithID assetPackID: String? = nil, options: Data.ReadingOptions = .mappedIfSafe) throws -> Data
```

## Parameters

`path`

The relative path.

`assetPackID`

The ID of the asset pack in which to search for the file. By default, all downloaded asset packs are searched.

`options`

Options for how to read the file’s contents into a `Data` instance.

## Return Value

The file’s contents.

## Discussion

All asset packs share the same namespace, so you can treat the overall collection of downloaded asset packs as if it were a single root directory that contains all of your subdirectories and asset files, regardless of the specific asset pack in which any particular file resides. If there’s a file-path collision across multiple asset packs, then it’s undefined from which asset pack the file will be read unless you explicitly limit the search to a particular asset pack by passing a non-`nil` ID to the `assetPackID` parameter.

> Throws: ``doc://com.apple.backgroundassets/documentation/BackgroundAssets/ManagedBackgroundAssetsError/fileNotFound(at:)`` when no file is found at `path`.

> Throws: When the path is not relative or when some other error occurs while finding or reading the requested file.

---

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)