XML::Validate::MSXML(3pm)				User Contributed Perl Documentation				 XML::Validate::MSXML(3pm)

NAME

       XML::Validate::MSXML - Interface to MSXML validator

SYNOPSIS

	 my $validator = new XML::Validate::MSXML(%options);
	 if ($doc = $validator->validate($xml)) {
	   ... Do stuff with $doc ...
	 } else {
	   print "Document is invalid
";
	 }

DESCRIPTION

       XML::Validate::MSXML is an interface to Microsoft's MSXML parser (often available in Windows environments) which can be used with the
       XML::Validate module.

METHODS

       new(%options)
	   Returns a new XML::Validate::MSXML instance using the specified options. (See OPTIONS below.)

       validate($xml)
	   Returns true if $xml could be successfully parsed, undef otherwise.

       last_dom()
	   Returns the MSXML DOM object of the document last validated.

       last_error()
	   Returns the error from the last validate call. This is a hash ref with the following fields:

       create_doc_and_cache()
	   Internal method for instantiation of MSXML DOMDocument and SchemaCache objects for use within the module.

       dependencies_available()
	   Internal method to determine that the necessary dependencies are available for instantiation of MSXML DOMDocument and SchemaCache
	   objects.

       load_schemas($msxml, $msxmlcache)
	   Internal method to perform loading of XML schema(s) into SchemaCache object.

	   o   message

	   o   line

	   o   column

	   Note that the error gets cleared at the beginning of each "validate" call.

       version()
	   Returns the version of the MSXML component that is installed

OPTIONS

       XML::Validate::MSXML takes the following options:

       strict_validation
	   If this boolean value is true, the document will be validated during parsing.  Otherwise it will only be checked for well-formedness.
	   Defaults to true.

ERROR REPORTING

       When a call to validate fails to parse the document, the error may be retrieved using last_error.

       On errors not related to the XML parsing, these methods will throw exceptions.  Wrap calls with eval to catch them.

PACKAGE GLOBALS

       $XML::Validate::MSXML::MSXML_VERSION contains the version number of MSXML.

DEPENDENCIES

       Win32::OLE, MSXML 4.0 or 5.0

VERSION

       $Revision: 1.18 $ on $Date: 2006/04/18 10:00:31 $ by $Author: mattheww $

AUTHOR

       Nathan Carr, Colin Robertson

       <cpan _at_ bbc _dot_ co _dot_ uk>

COPYRIGHT

       (c) BBC 2005. This program is free software; you can redistribute it and/or modify it under the GNU GPL.  See the file COPYING in this
       distribution, or http://www.gnu.org/licenses/gpl.txt

perl v5.10.1							    2006-04-19						 XML::Validate::MSXML(3pm)