---
title: "MusicSequenceBeatsToBarBeatTime(_:_:_:_:)"
framework: audiotoolbox
role: symbol
role_heading: Function
path: "audiotoolbox/musicsequencebeatstobarbeattime(_:_:_:_:)"
---

# MusicSequenceBeatsToBarBeatTime(_:_:_:_:)

Formats a music sequence’s beat time to its bar-beat time.

## Declaration

```swift
func MusicSequenceBeatsToBarBeatTime(_ inSequence: MusicSequence, _ inBeats: MusicTimeStamp, _ inSubbeatDivisor: UInt32, _ outBarBeatTime: UnsafeMutablePointer<CABarBeatTime>) -> OSStatus
```

## Parameters

- `inSequence`: The music sequence that you want bar-beat time for.
- `inBeats`: The beats to be represented as bar-beats.
- `inSubbeatDivisor`: The denominator of the fractional number of beats.
- `outBarBeatTime`: On output, the music sequence’s bar-beat time.

## Return Value

Return Value A result code.

## Discussion

Discussion The sequence’s tempo track time signature events are used to calculate the bar-beat representation. If there are no Time Sig events added to the sequence 4/4 is assumed. A time signature event is a MIDI Meta Event as specified for MIDI files. Refer to AudioToolbox/CAClock.h for more information.

## See Also

### Managing Music Sequences

- [NewMusicSequence(_:)](audiotoolbox/newmusicsequence(_:).md)
- [DisposeMusicSequence(_:)](audiotoolbox/disposemusicsequence(_:).md)
- [MusicSequenceBarBeatTimeToBeats(_:_:_:)](audiotoolbox/musicsequencebarbeattimetobeats(_:_:_:).md)
- [MusicSequenceDisposeTrack(_:_:)](audiotoolbox/musicsequencedisposetrack(_:_:).md)
- [MusicSequenceFileCreate(_:_:_:_:_:)](audiotoolbox/musicsequencefilecreate(_:_:_:_:_:).md)
- [MusicSequenceFileCreateData(_:_:_:_:_:)](audiotoolbox/musicsequencefilecreatedata(_:_:_:_:_:).md)
- [MusicSequenceFileLoad(_:_:_:_:)](audiotoolbox/musicsequencefileload(_:_:_:_:).md)
- [MusicSequenceFileLoadData(_:_:_:_:)](audiotoolbox/musicsequencefileloaddata(_:_:_:_:).md)
- [MusicSequenceGetAUGraph(_:_:)](audiotoolbox/musicsequencegetaugraph(_:_:).md)
- [MusicSequenceGetBeatsForSeconds(_:_:_:)](audiotoolbox/musicsequencegetbeatsforseconds(_:_:_:).md)
- [MusicSequenceGetIndTrack(_:_:_:)](audiotoolbox/musicsequencegetindtrack(_:_:_:).md)
- [MusicSequenceGetInfoDictionary(_:)](audiotoolbox/musicsequencegetinfodictionary(_:).md)
- [MusicSequenceGetSMPTEResolution(_:_:_:)](audiotoolbox/musicsequencegetsmpteresolution(_:_:_:).md)
- [MusicSequenceGetSecondsForBeats(_:_:_:)](audiotoolbox/musicsequencegetsecondsforbeats(_:_:_:).md)
- [MusicSequenceGetSequenceType(_:_:)](audiotoolbox/musicsequencegetsequencetype(_:_:).md)