HTTP::...ormats(3pm)

💖 NAME 💖

ok so this is HTTP::OAI::ListMetadataFormats — she's your lil bestie for getting at an OAI ListMetadataFormats response. that's it, that's the whole job, and she eats every time ✨

it's a Perl module, filed under User Contributed Perl Documentation as HTTP::OAI::ListMetadataFormats(3pm). 🎀

---

🌸 SYNOPSIS 🌸

my $r = $h->ListMetadataFormats;

# ListMetadataFormats doesn't use flow control
while( my $rec = $r->next ) {
        print $rec->metadataPrefix, "\n";
}

die $r->message if $r->is_error;

ok bestie notice the comment: ListMetadataFormats doesn't use flow control, so don't go looking for it, she simply doesn't do that 💅

---

✨ METHODS ✨

• $lmdf = new HTTP::OAI::ListMetadataFormats — the constructor, periodt. hand her over and she gives you back a brand new HTTP::OAI::ListMetadataFormats object. 🦋
• $mdf = $lmdf->next — she hands you back either an HTTP::OAI::MetadataFormat object, or undef if there's literally no more records left to give. that undef is your cue to stop, no cap. 🙈
• @mdfl = $lmdf->metadataFormat([$mdf]) — gives you back the metadataFormat list, and if you want, you can pass in a new metadataFormat $mdf and she'll add it for you. returns an array ref of HTTP::OAI::MetadataFormats. 👑
• $dom = $lmdf->toDOM — returns an XML::DOM object that represents the ListMetadataFormats response. DOM as in document object model, iykyk 🌈

---

lowkey important: next giving you undef is not a bug, it's the signal. it's giving "we're done here." 🫶

---

and that's the whole page, babe — written by the lovely people behind perl v5.36.0, dated 2023-09-28, and lovingly relayed to you by the HTTP::...ormats(3pm) manual. go forth and list those metadata formats 💜🌸💅