<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.13.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Metal",
  "identifier" : "/documentation/Metal/MTLDevice/heapBufferSizeAndAlign(length:options:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Metal"
    ],
    "preciseIdentifier" : "c:objc(pl)MTLDevice(im)heapBufferSizeAndAlignWithLength:options:"
  },
  "title" : "heapBufferSizeAndAlign(length:options:)"
}
-->

# heapBufferSizeAndAlign(length:options:)

Returns the size and alignment, in bytes, of a buffer if you create it from a heap.

```
func heapBufferSizeAndAlign(length: Int, options: MTLResourceOptions = []) -> MTLSizeAndAlign
```

## Parameters

`length`

The size of the buffer, in bytes.

`options`

An [`MTLResourceOptions`](/documentation/Metal/MTLResourceOptions) instance for a would-be buffer’s storage and hazard tracking modes. See [Resource fundamentals](/documentation/Metal/resource-fundamentals) and [Setting resource storage modes](/documentation/Metal/setting-resource-storage-modes) for more information.

## Return Value

An [`MTLSizeAndAlign`](/documentation/Metal/MTLSizeAndAlign) instance.

## Discussion

Use this method to help estimate an appropriate size for a new heap before you create it.

---

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)