WildMidi_GetLyric(3)

💖 WildMidi_GetLyric — the WildMidi Programmer's Manual, bestie edition 💖

okay so real talk, this is a page from the WildMidi Programmer's Manual and it's literally all about snatching the lyrics out of a MIDI file. yes, MIDI files can have lyrics. iconic behavior. let's get into it 🎤✨

✨ NAME ✨

WildMidi_GetLyric — get lyrics of a midi 🎶💬

📚 LIBRARY 📚

libWildMidi — she's the one holding all the good stuff 🫶

🌸 SYNOPSIS 🌸

#include <wildmidi_lib.h>

char *WildMidi_GetLyric (midi *handle);

like. one include, one function call, and the lyric is yours. slay 💅

🦋 DESCRIPTION 🦋

So basically this function hands you back a pointer to a nul terminated string that contains all the data from the last read lyric or text meta event. that's the whole vibe.

OR — and this is the plot twist — it returns NULL if there's no lyric just sitting there waiting to be read. no lyric, no pointer, no drama 😭

The argument situation:

• handle — the identifier you got from opening a midi file with WildMidi_Open(3) or WildMidi_OpenBuffer(3). it's your little ticket to the midi party 🎟️

⭐ RETURN VALUE ⭐

On error it returns NULL, and an error message gets displayed to stderr — so if something's off, she will tell you, loudly, on the error stream 💀

Otherwise? it returns a pointer to a *char containing the lyric data. main character pointer energy, periodt 👑

👀 SEE ALSO 👀

the whole friend group, obviously:

• WildMidi_GetVersion(3)
• WildMidi_Init(3)
• WildMidi_MasterVolume(3)
• WildMidi_Open(3)
• WildMidi_OpenBuffer(3)
• WildMidi_SetOption(3)
• WildMidi_GetOutput(3)
• WildMidi_GetMidiOutput(3)
• WildMidi_FastSeek(3)
• WildMidi_Close(3)
• WildMidi_Shutdown(3)
• wildmidi.cfg(5)

💜 AUTHOR 💜

Chris Ison <chrisisonwildcode@gmail.com> and Bret Curtis <psi29a@gmail.com> — the actual legends who made this happen 🫡✨

🎀 COPYRIGHT 🎀

Copyright (C) WildMidi Developers 2001-2016

This file is part of WildMIDI.

WildMIDI is free software: you can redistribute and/or modify the player under the terms of the GNU General Public License and you can redistribute and/or modify the library under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the licenses, or (at your option) any later version.

WildMIDI is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License and the GNU Lesser General Public License for more details.

You should have received a copy of the GNU General Public License and the GNU Lesser General Public License along with WildMIDI. If not, see <http://www.gnu.org/licenses/>.

ok so this part is the legal bit and you cannot skip it, bestie, it's giving very much "required reading" 😤

This manpage is licensed under the Creative Commons Attribution-Share Alike 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

and that's the whole page!! 🎉 this version of the WildMidi Programmer's Manual page for WildMidi_GetLyric(3) is dated 10 March 2016, and yeah it came straight out of the WildMidi Programmer's Manual lineup. go read your lyrics, you've earned it 💖🦋🌸