目次 - SDL_mixer - API(機能別) - 音楽 - Mix_GetMusicTitle

Mix_GetMusicTitle

音楽オブジェクトのタイトル名またはファイル名を得る

構文

const char *Mix_GetMusicTitle(const Mix_Music *music);

引数

music問い合わせる音楽オブジェクト. NULLのとき現在再生中の音楽

戻り値

音楽のタイトル名, 存在しない場合はファイル名, または""を戻す.

詳細

この関数はフォーマット依存のメタデータを戻す. 全てのファイル形式に存在するとは限らない.

musicがNULLの場合, 現在再生中の音楽から得ようとする.

タイトル名タグが存在しない, または空の場合, ファイル名が戻される. 実際のメタデータ, または空の方が望ましい場合は, 代わりにMix_GetMusicTitleTag()を使用すること.

音楽をファイル名ではなくSDL_RWopsで読み込んだ場合, 戻されるファイル名は空文字("")なので注意すること.

この関数がNULLを戻すことはない. データが得られなかった場合は空文字列("")を戻す.

バージョン

SDL_mixer 2.6.0以降

関連項目(関数)

Mix_GetMusicAlbumTag
Mix_GetMusicArtistTag
Mix_GetMusicCopyrightTag
Mix_GetMusicTitleTag

SDL Wikiへのリンク

SDL2_mixer/Mix_GetMusicTitle