---
title: "CMTimeRangeCopyDescription(allocator:range:)"
framework: Core Media
role: symbol
role_heading: Function
platforms: [iOS 4.0+, iPadOS 4.0+, Mac Catalyst 13.1+, macOS 10.7+, tvOS 9.0+, visionOS 1.0+, watchOS 6.0+]
path: "coremedia/cmtimerangecopydescription(allocator:range:)"
---

# CMTimeRangeCopyDescription(allocator:range:)

Returns a string with a description of a time range.

## Declaration

```swift
func CMTimeRangeCopyDescription(allocator: CFAllocator?, range: CMTimeRange) -> CFString?
```

## Parameters

- `allocator`: The allocator the function uses when allocating memory for the description.
- `range`: The time range to describe.

## Return Value

Return Value A string description.

## Discussion

Discussion You use this from within CFShow on an object that contains CMTimeRange fields. It is also useful from other client debugging code.  The caller owns the CFString this function returns and is responsible for releasing it. Pass kCFAllocatorDefault to use the default allocator.

## See Also

### Utility Functions

- [CMTimeClampToRange(_:range:)](coremedia/cmtimeclamptorange(_:range:).md)
- [CMTimeMapDurationFromRangeToRange(_:fromRange:toRange:)](coremedia/cmtimemapdurationfromrangetorange(_:fromrange:torange:).md)
- [CMTimeMapTimeFromRangeToRange(_:fromRange:toRange:)](coremedia/cmtimemaptimefromrangetorange(_:fromrange:torange:).md)
- [CMTimeRangeCopyAsDictionary(_:allocator:)](coremedia/cmtimerangecopyasdictionary(_:allocator:).md)
- [CMTimeRangeShow(_:)](coremedia/cmtimerangeshow(_:).md)