int Mix_EachSoundFont(int (SDLCALL *function)(const char*, void*), void *data)
function | パスごとに呼ばれるコールバック関数 |
data | コールバック関数で使用するためにコールバック関数に渡すポインタ |
この関数は, Mix_GetSoundFonts()が報告したセミコロンで区切られたパスの文字列を分割し, それぞれのパスごとにコールバック関数を呼び出す.
利用可能なパスがない場合, この関数はコールバックを呼ばずに0を戻す.
コールバックが0以外を戻すと, この関数は繰り返しを止めて0以外を戻す. コールバックが0を戻すと, この関数は繰り返しを継続し, 次のパスで再びコールバックを呼び出す. コールバックが0以外を一度も戻さなかったならば, この関数は0を戻す. これは目的のサウンドフォントが見つかったかを判断するために使える.