---
title: "MusicTrackCut(_:_:_:)"
framework: audiotoolbox
role: symbol
role_heading: Function
path: "audiotoolbox/musictrackcut(_:_:_:)"
---

# MusicTrackCut(_:_:_:)

Removes a specified range of music track events, and shifts later events toward the start of the track to fill in the gap.

## Declaration

```swift
func MusicTrackCut(_ inTrack: MusicTrack, _ inStartTime: MusicTimeStamp, _ inEndTime: MusicTimeStamp) -> OSStatus
```

## Parameters

- `inTrack`: The music track that you want to cut events from.
- `inStartTime`: The start time, in beats, for the range of music track events that you want to cut.
- `inEndTime`: The end time, in beats, for the range of music track events that you want to cut.

## Return Value

Return Value A result code.

## Discussion

Discussion The inStartTime value must be less than the inEndTime value.

## See Also

### Managing Music Tracks

- [MusicTrackClear(_:_:_:)](audiotoolbox/musictrackclear(_:_:_:).md)
- [MusicTrackCopyInsert(_:_:_:_:_:)](audiotoolbox/musictrackcopyinsert(_:_:_:_:_:).md)
- [MusicTrackGetDestMIDIEndpoint(_:_:)](audiotoolbox/musictrackgetdestmidiendpoint(_:_:).md)
- [MusicTrackGetDestNode(_:_:)](audiotoolbox/musictrackgetdestnode(_:_:).md)
- [MusicTrackGetProperty(_:_:_:_:)](audiotoolbox/musictrackgetproperty(_:_:_:_:).md)
- [MusicTrackGetSequence(_:_:)](audiotoolbox/musictrackgetsequence(_:_:).md)
- [MusicTrackMerge(_:_:_:_:_:)](audiotoolbox/musictrackmerge(_:_:_:_:_:).md)
- [MusicTrackMoveEvents(_:_:_:_:)](audiotoolbox/musictrackmoveevents(_:_:_:_:).md)
- [MusicTrackNewAUPresetEvent(_:_:_:)](audiotoolbox/musictracknewaupresetevent(_:_:_:).md)
- [MusicTrackNewExtendedNoteEvent(_:_:_:)](audiotoolbox/musictracknewextendednoteevent(_:_:_:).md)
- [MusicTrackNewExtendedTempoEvent(_:_:_:)](audiotoolbox/musictracknewextendedtempoevent(_:_:_:).md)
- [MusicTrackNewMIDIChannelEvent(_:_:_:)](audiotoolbox/musictracknewmidichannelevent(_:_:_:).md)
- [MusicTrackNewMIDINoteEvent(_:_:_:)](audiotoolbox/musictracknewmidinoteevent(_:_:_:).md)
- [MusicTrackNewMIDIRawDataEvent(_:_:_:)](audiotoolbox/musictracknewmidirawdataevent(_:_:_:).md)
- [MusicTrackNewMetaEvent(_:_:_:)](audiotoolbox/musictracknewmetaevent(_:_:_:).md)
