<?php

namespace Safe;

use Safe\Exceptions\XmlException;

/**
 * xml_parser_create_ns creates a new XML parser
 * with XML namespace support and returns a resource handle referencing
 * it to be used by the other XML functions.
 *
 * @param string $encoding The input encoding is automatically detected, so that the
 * encoding parameter specifies only the output
 * encoding. In PHP 5.0.0 and 5.0.1, the default output charset is
 * ISO-8859-1, while in PHP 5.0.2 and upper is UTF-8. The supported
 * encodings are ISO-8859-1, UTF-8 and
 * US-ASCII.
 * @param string $separator With a namespace aware parser tag parameters passed to the various
 * handler functions will consist of namespace and tag name separated by
 * the string specified in separator.
 * @return resource Returns a resource handle for the new XML parser.
 * @throws XmlException
 *
 */
function xml_parser_create_ns(?string $encoding = null, string $separator = ":")
{
    error_clear_last();
    if ($separator !== ":") {
        $result = \xml_parser_create_ns($encoding, $separator);
    } elseif ($encoding !== null) {
        $result = \xml_parser_create_ns($encoding);
    } else {
        $result = \xml_parser_create_ns();
    }
    if ($result === false) {
        throw XmlException::createFromPhpError();
    }
    return $result;
}


/**
 * xml_parser_create creates a new XML parser
 * and returns a resource handle referencing it to be used by the
 * other XML functions.
 *
 * @param string $encoding The optional encoding specifies the character
 * encoding for the input/output in PHP 4. Starting from PHP 5, the input
 * encoding is automatically detected, so that the
 * encoding parameter specifies only the output
 * encoding. In PHP 4, the default output encoding is the same as the
 * input charset. If empty string is passed, the parser attempts to identify
 * which encoding the document is encoded in by looking at the heading 3 or
 * 4 bytes. In PHP 5.0.0 and 5.0.1, the default output charset is
 * ISO-8859-1, while in PHP 5.0.2 and upper is UTF-8. The supported
 * encodings are ISO-8859-1, UTF-8 and
 * US-ASCII.
 * @return resource Returns a resource handle for the new XML parser.
 * @throws XmlException
 *
 */
function xml_parser_create(?string $encoding = null)
{
    error_clear_last();
    if ($encoding !== null) {
        $result = \xml_parser_create($encoding);
    } else {
        $result = \xml_parser_create();
    }
    if ($result === false) {
        throw XmlException::createFromPhpError();
    }
    return $result;
}


/**
 * This function allows to use parser inside
 * object. All callback functions could be set with
 * xml_set_element_handler etc and assumed to be
 * methods of object.
 *
 * @param resource $parser A reference to the XML parser to use inside the object.
 * @param object $object The object where to use the XML parser.
 * @throws XmlException
 *
 */
function xml_set_object($parser, object &$object): void
{
    error_clear_last();
    $result = \xml_set_object($parser, $object);
    if ($result === false) {
        throw XmlException::createFromPhpError();
    }
}