XML::SAX::ExpatXS(3)

💖 NAME 💖

XML::SAX::ExpatXS — Perl SAX 2 XS extension to Expat parser. This is the XML::SAX::ExpatXS(3) page from the User Contributed Perl Documentation, and yes bestie, you're in the right place. Main character energy for XML parsing, fr fr. 💅

✨ SYNOPSIS ✨

use XML::SAX::ExpatXS;

$handler = MyHandler->new();
$parser = XML::SAX::ExpatXS->new( Handler => $handler );
$parser->parse_uri($uri);
 #or
$parser->parse_string($xml);

🌸 DESCRIPTION 🌸

Okay so XML::SAX::ExpatXS is a direct XS extension to Expat XML parser. It implements the Perl SAX 2.1 interface. For the Perl SAX API description, see http://perl-xml.sourceforge.net/perl-sax/. Any deviations from the Perl SAX 2.1 specification are considered as bugs — no cap, that's literally the rule. 🫶

🎀 Features 🎀

The parser behavior can be changed by setting features, like this:

$parser->set_feature(FEATURE, VALUE);

XML::SAX::ExpatXS provides these adjustable features:

• http://xmlns.perl.org/sax/join-character-data — consequent character data are joined (1, default) or not (0). ✨
• http://xmlns.perl.org/sax/ns-attributes — namespace attributes are reported as common attributes (1, default) or not (0). 🦋
• http://xmlns.perl.org/sax/xmlns-uris — when set on, xmlns and xmlns:* attributes are put into namespaces in a Perl SAX traditional way; xmlns attributes are in no namespace while xmlns:* attributes are in the http://www.w3.org/2000/xmlns/ namespace. This feature is set to 1 by default. 💅
• http://xml.org/sax/features/xmlns-uris — this feature applies if and only if the http://xmlns.perl.org/sax/xmlns-uris feature is off. Then, xmlns and xmlns:* attributes are both put into no namespace (0, default) or into http://www.w3.org/2000/xmlns/ namespace (1). 🌈
• http://xmlns.perl.org/sax/locator — the document locator is updated (1, default) for ContentHadler events or not (0). 🍓
• http://xmlns.perl.org/sax/recstring — a recognized string (the text string currently processed by this XML parser) is either maintained as $parser->{ParseOptions}{RecognizedString} (1) or not (0, default). 🔥
• http://xml.org/sax/features/external-general-entities — controls whether this parser processes external general entities (1, default) or not (0). 👑
• http://xml.org/sax/features/external-parameter-entities — controls whether this parser processes external parameter entities including an external DTD subset (1) or not (0, default). 🌟

🧸 Constructor Options 🧸

Apart from features, the behavior of this parser can also be changed with options to the constructor. Bestie, these are the old-school knobs:

ParseParamEnt

ParseParamEnt => 1

The meaning of this option is exactly the same as the http://xml.org/sax/features/external-parameter-entities feature. The option is supported only because of compatibility with older versions of this module. Turned off by default. 🙈

NoExpand

NoExpand => 1

No internal entities are expanded if this option is turned on. Turned off by default. 🎀

👑 Read-only Properties 👑

ExpatVersion

This property returns a version of linked Expat library, for example expat_1.95.7. Iconic. ⭐

💜 AUTHORS 💜

• Petr Cimprich <pcimprich AT gmail DOT com> (maintainer)
• Matt Sergeant <matt AT sergeant DOT org>

🦋 COPYRIGHT 🦋

2002-2004 Matt Sergeant, 2004-2011 Petr Cimprich. All rights reserved.

🌈 LICENSE 🌈

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Periodt. 💖

---

🫶 Cute little sign-off: this XML::SAX::ExpatXS(3) page is from perl v5.42.0, dated 2024-01-20. Bye bestie! 💅