<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MetricKit",
  "identifier" : "/documentation/MetricKit/CallStackFrame",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "MetricKit"
    ],
    "preciseIdentifier" : "s:9MetricKit14CallStackFrameV"
  },
  "title" : "CallStackFrame"
}
-->

# CallStackFrame

A single frame within a call stack thread.

```
struct CallStackFrame
```

## Discussion

Each frame may have sub-frames that form a call tree. The [`binaryUUID`](/documentation/MetricKit/CallStackFrame/binaryUUID) references binary metadata in the parent [`binaryInfo`](/documentation/MetricKit/CallStackTree/binaryInfo-swift.property) dictionary. Use [`binaryName(from:)`](/documentation/MetricKit/CallStackFrame/binaryName(from:)) to look up the binary name for a given frame:

```swift
if let name = frame.binaryName(from: tree) {
    print(name)
}
```

## Topics

### Frame details

[`let binaryUUID: UUID?`](/documentation/MetricKit/CallStackFrame/binaryUUID)

Binary UUID (references CallStackTree.binaryInfo)

[`let address: UInt64?`](/documentation/MetricKit/CallStackFrame/address)

Absolute address

[`let offsetIntoBinaryTextSegment: UInt64?`](/documentation/MetricKit/CallStackFrame/offsetIntoBinaryTextSegment)

Offset into binary text segment

[`let sampleCount: Int?`](/documentation/MetricKit/CallStackFrame/sampleCount)

Sample count (for sampled stack traces)

### Tree navigation

[`let subFrames: ContiguousArray<CallStackFrame>`](/documentation/MetricKit/CallStackFrame/subFrames)

Sub-frames (children in the call tree)

[`func binaryName(from: CallStackTree) -> String?`](/documentation/MetricKit/CallStackFrame/binaryName(from:))

Binary name - look up from tree

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Hashable`](/documentation/Swift/Hashable)

[`Decodable`](/documentation/Swift/Decodable)

[`Equatable`](/documentation/Swift/Equatable)

[`Encodable`](/documentation/Swift/Encodable)

[`Sendable`](/documentation/Swift/Sendable)

---

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)