GOLF(2gg)

💅 GOLF(2gg) — write-message

okay bestie, welcome to the GOLF(2gg) section of the manual (that's the Development corner of the docs, iykyk) 🌸

---

✨ NAME ✨

write-message — the one that writes stuff into a message (it lives in the messages family 🎀)

---

🎯 PURPOSE 🎯

Write a key/value pair into a message. that's it, that's the whole job, and it ate 💅

---

📝 SYNTAX 📝

write-message <message>  key <key> value <value>

---

💖 DESCRIPTION 💖

so here's the tea, bestie: write-message appends a key/value pair onto <message>. the pair is made of the string <key> (that's the one sitting in the key clause) and the string <value> (that one's in the value clause). two little strings, one cute couple, added to the end of the message. periodt ✨

now for the rules, and you will respect the rules:

• <message> must have been created with new-message first. no new-message, no message, no vibes. 🫶
• to use write-message, a message must not have been read from. (peep read-message if you wanna know why.) so basically: write first, read later, main character order. 🙈

lowkey important: if the message has already been read from, write-message is not the move. do not attempt. the manual said what it said. 💀

---

🌈 EXAMPLES 🌈

make a message, then write into it. iconic two-step:

new-message msg
write-message msg key "key1" value "value1"

look at her go 🦋

---

👀 SEE ALSO 👀

• Messages — the whole family, go say hi 🎀
• get-message
• new-message
• read-message
• SEMI
• write-message
• ...and honestly just go read all documentation, it's giving knowledge ✨

---

and that's a wrap, gorgeous 💜 this page came to you courtesy of the $VERSION edition, dated $DATE, signed off under the GOLF(2gg) banner. mwah, go write some messages 👑🍓