MSR_DUPLICATE(3)

💖 MSR_DUPLICATE(3) 💖

okay bestie, so you found your way into libmseed, the library functions manual, and specifically the page for msr_duplicate. Manual name? MSR_DUPLICATE. Vibe? iconic. Let's get into it ✨

---

🌸 NAME 🌸

msr_duplicate — duplicate an MSRecord structure

---

🎀 SYNOPSIS 🎀

#include <libmseed.h>

MSRecord *msr_duplicate ( MSRecord *msr, flag datadup );

---

🦋 DESCRIPTION 🦋

So basically, msr_duplicate makes a copy of an MSRecord structure — and not just the top layer, no ma'am, it goes all the way down through every substructure too, the FSDH and the whole blockette chain. Full clone energy. 👑

Now here's the part where you actually have to pay attention: the datadup flag is the main character here.

• if datadup is true — the data samples from msr get duplicated too 🫶
• if datadup is false — the copy MSRecord will have no associated data sample array at all, regardless of whether the source MSRecord had one

like, zero data. not empty, just... not there. no cap. 💀

---

💅 RETURN VALUE 💅

msr_duplicate returns a pointer to an MSRecord on success, and NULL on error. that's it, that's the whole story — check for NULL, bestie, don't be out here dereferencing your problems away 😭

---

👀 SEE ALSO 👀

• ms_intro(3)

---

🌈 AUTHOR 🌈

Chad Trabant IRIS Data Management Center

---

and that's the whole page, fr fr 💜 this was the Libmseed API manual, dated 2007/04/28, filed under MSR_DUPLICATE(3). slay, go duplicate responsibly ✨🎀