slidge-whatsapp 0.2.2__cp312-cp312-manylinux_2_36_aarch64.whl → 0.2.5__cp312-cp312-manylinux_2_36_aarch64.whl

slidge_whatsapp/vendor/github.com/gen2brain/go-fitz/include/mupdf/fitz/writer.h

@@ -0,0 +1,266 @@
+// Copyright (C) 2004-2023 Artifex Software, Inc.
+//
+// This file is part of MuPDF.
+//
+// MuPDF is free software: you can redistribute it and/or modify it under the
+// terms of the GNU Affero General Public License as published by the Free
+// Software Foundation, either version 3 of the License, or (at your option)
+// any later version.
+//
+// MuPDF is distributed in the hope that it will be useful, but WITHOUT ANY
+// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+// FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+// details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with MuPDF. If not, see <https://www.gnu.org/licenses/agpl-3.0.en.html>
+//
+// Alternative licensing terms are available from the licensor.
+// For commercial licensing, see <https://www.artifex.com/> or contact
+// Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
+// CA 94129, USA, for further information.
+
+#ifndef MUPDF_FITZ_WRITER_H
+#define MUPDF_FITZ_WRITER_H
+
+#include "mupdf/fitz/system.h"
+#include "mupdf/fitz/context.h"
+#include "mupdf/fitz/output.h"
+#include "mupdf/fitz/document.h"
+#include "mupdf/fitz/device.h"
+
+typedef struct fz_document_writer fz_document_writer;
+
+/**
+	Function type to start
+	the process of writing a page to a document.
+
+	mediabox: page size rectangle in points.
+
+	Returns a fz_device to write page contents to.
+*/
+typedef fz_device *(fz_document_writer_begin_page_fn)(fz_context *ctx, fz_document_writer *wri, fz_rect mediabox);
+
+/**
+	Function type to end the
+	process of writing a page to a document.
+
+	dev: The device created by the begin_page function.
+*/
+typedef void (fz_document_writer_end_page_fn)(fz_context *ctx, fz_document_writer *wri, fz_device *dev);
+
+/**
+	Function type to end
+	the process of writing pages to a document.
+
+	This writes any file level trailers required. After this
+	completes successfully the file is up to date and complete.
+*/
+typedef void (fz_document_writer_close_writer_fn)(fz_context *ctx, fz_document_writer *wri);
+
+/**
+	Function type to discard
+	an fz_document_writer. This may be called at any time during
+	the process to release all the resources owned by the writer.
+
+	Calling drop without having previously called close may leave
+	the file in an inconsistent state and the user of the
+	fz_document_writer would need to do any cleanup required.
+*/
+typedef void (fz_document_writer_drop_writer_fn)(fz_context *ctx, fz_document_writer *wri);
+
+#define fz_new_derived_document_writer(CTX,TYPE,BEGIN_PAGE,END_PAGE,CLOSE,DROP) \
+	((TYPE *)Memento_label(fz_new_document_writer_of_size(CTX,sizeof(TYPE),BEGIN_PAGE,END_PAGE,CLOSE,DROP),#TYPE))
+
+/**
+	Look for a given option (key) in the opts string. Return 1 if
+	it has it, and update *val to point to the value within opts.
+*/
+int fz_has_option(fz_context *ctx, const char *opts, const char *key, const char **val);
+
+/**
+	Check to see if an option, a, from a string matches a reference
+	option, b.
+
+	(i.e. a could be 'foo' or 'foo,bar...' etc, but b can only be
+	'foo'.)
+*/
+int fz_option_eq(const char *a, const char *b);
+
+/**
+	Copy an option (val) into a destination buffer (dest), of maxlen
+	bytes.
+
+	Returns the number of bytes (including terminator) that did not
+	fit. If val is maxlen or greater bytes in size, it will be left
+	unterminated.
+*/
+size_t fz_copy_option(fz_context *ctx, const char *val, char *dest, size_t maxlen);
+
+/**
+	Create a new fz_document_writer, for a
+	file of the given type.
+
+	path: The document name to write (or NULL for default)
+
+	format: Which format to write (currently cbz, html, pdf, pam,
+	pbm, pgm, pkm, png, ppm, pnm, svg, text, xhtml, docx, odt)
+
+	options: NULL, or pointer to comma separated string to control
+	file generation.
+*/
+fz_document_writer *fz_new_document_writer(fz_context *ctx, const char *path, const char *format, const char *options);
+
+/**
+	Like fz_new_document_writer but takes a fz_output for writing
+	the result. Only works for multi-page formats.
+*/
+fz_document_writer *
+fz_new_document_writer_with_output(fz_context *ctx, fz_output *out, const char *format, const char *options);
+
+fz_document_writer *
+fz_new_document_writer_with_buffer(fz_context *ctx, fz_buffer *buf, const char *format, const char *options);
+
+/**
+	Document writers for various possible output formats.
+
+	All of the "_with_output" variants pass the ownership of out in
+	immediately upon calling. The writers are responsible for
+	dropping the fz_output when they are finished with it (even
+	if they throw an exception during creation).
+*/
+fz_document_writer *fz_new_pdf_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pdf_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+fz_document_writer *fz_new_svg_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_svg_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+
+fz_document_writer *fz_new_text_writer(fz_context *ctx, const char *format, const char *path, const char *options);
+fz_document_writer *fz_new_text_writer_with_output(fz_context *ctx, const char *format, fz_output *out, const char *options);
+
+fz_document_writer *fz_new_odt_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_odt_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+fz_document_writer *fz_new_docx_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_docx_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+
+fz_document_writer *fz_new_ps_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_ps_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+fz_document_writer *fz_new_pcl_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pcl_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+fz_document_writer *fz_new_pclm_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pclm_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+fz_document_writer *fz_new_pwg_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pwg_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+
+fz_document_writer *fz_new_cbz_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_cbz_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+
+/**
+	Used to report progress of the OCR operation.
+
+	page: Current page being processed.
+
+	percent: Progress of the OCR operation for the
+	current page in percent. Whether it reaches 100
+	once a page is finished, depends on the OCR engine.
+
+	Return 0 to continue progress, return 1 to cancel the
+	operation.
+*/
+typedef int (fz_pdfocr_progress_fn)(fz_context *ctx, void *progress_arg, int page, int percent);
+
+fz_document_writer *fz_new_pdfocr_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pdfocr_writer_with_output(fz_context *ctx, fz_output *out, const char *options);
+void fz_pdfocr_writer_set_progress(fz_context *ctx, fz_document_writer *writer, fz_pdfocr_progress_fn *progress, void *);
+
+fz_document_writer *fz_new_jpeg_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_png_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pam_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pnm_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pgm_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_ppm_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pbm_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+fz_document_writer *fz_new_pkm_pixmap_writer(fz_context *ctx, const char *path, const char *options);
+
+/**
+	Called to start the process of writing a page to
+	a document.
+
+	mediabox: page size rectangle in points.
+
+	Returns a borrowed fz_device to write page contents to. This
+	should be kept if required, and only dropped if it was kept.
+*/
+fz_device *fz_begin_page(fz_context *ctx, fz_document_writer *wri, fz_rect mediabox);
+
+/**
+	Called to end the process of writing a page to a
+	document.
+*/
+void fz_end_page(fz_context *ctx, fz_document_writer *wri);
+
+/**
+	Convenience function to feed all the pages of a document to
+	fz_begin_page/fz_run_page/fz_end_page.
+*/
+void fz_write_document(fz_context *ctx, fz_document_writer *wri, fz_document *doc);
+
+/**
+	Called to end the process of writing
+	pages to a document.
+
+	This writes any file level trailers required. After this
+	completes successfully the file is up to date and complete.
+*/
+void fz_close_document_writer(fz_context *ctx, fz_document_writer *wri);
+
+/**
+	Called to discard a fz_document_writer.
+	This may be called at any time during the process to release all
+	the resources owned by the writer.
+
+	Calling drop without having previously called close may leave
+	the file in an inconsistent state.
+*/
+void fz_drop_document_writer(fz_context *ctx, fz_document_writer *wri);
+
+fz_document_writer *fz_new_pixmap_writer(fz_context *ctx, const char *path, const char *options, const char *default_path, int n,
+	void (*save)(fz_context *ctx, fz_pixmap *pix, const char *filename));
+
+FZ_DATA extern const char *fz_pdf_write_options_usage;
+FZ_DATA extern const char *fz_svg_write_options_usage;
+
+FZ_DATA extern const char *fz_pcl_write_options_usage;
+FZ_DATA extern const char *fz_pclm_write_options_usage;
+FZ_DATA extern const char *fz_pwg_write_options_usage;
+FZ_DATA extern const char *fz_pdfocr_write_options_usage;
+
+/* Implementation details: subject to change. */
+
+/**
+	Structure is public to allow other structures to
+	be derived from it. Do not access members directly.
+*/
+struct fz_document_writer
+{
+	fz_document_writer_begin_page_fn *begin_page;
+	fz_document_writer_end_page_fn *end_page;
+	fz_document_writer_close_writer_fn *close_writer;
+	fz_document_writer_drop_writer_fn *drop_writer;
+	fz_device *dev;
+};
+
+/**
+	Internal function to allocate a
+	block for a derived document_writer structure, with the base
+	structure's function pointers populated correctly, and the extra
+	space zero initialised.
+*/
+fz_document_writer *fz_new_document_writer_of_size(fz_context *ctx, size_t size,
+		fz_document_writer_begin_page_fn *begin_page,
+		fz_document_writer_end_page_fn *end_page,
+		fz_document_writer_close_writer_fn *close,
+		fz_document_writer_drop_writer_fn *drop);
+
+
+
+#endif

slidge_whatsapp/vendor/github.com/gen2brain/go-fitz/include/mupdf/fitz/xml.h

@@ -0,0 +1,397 @@
+// Copyright (C) 2004-2022 Artifex Software, Inc.
+//
+// This file is part of MuPDF.
+//
+// MuPDF is free software: you can redistribute it and/or modify it under the
+// terms of the GNU Affero General Public License as published by the Free
+// Software Foundation, either version 3 of the License, or (at your option)
+// any later version.
+//
+// MuPDF is distributed in the hope that it will be useful, but WITHOUT ANY
+// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+// FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+// details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with MuPDF. If not, see <https://www.gnu.org/licenses/agpl-3.0.en.html>
+//
+// Alternative licensing terms are available from the licensor.
+// For commercial licensing, see <https://www.artifex.com/> or contact
+// Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
+// CA 94129, USA, for further information.
+
+#ifndef MUPDF_FITZ_XML_H
+#define MUPDF_FITZ_XML_H
+
+#include "mupdf/fitz/system.h"
+#include "mupdf/fitz/context.h"
+#include "mupdf/fitz/buffer.h"
+#include "mupdf/fitz/pool.h"
+#include "mupdf/fitz/archive.h"
+
+/**
+	XML document model
+*/
+
+typedef struct fz_xml fz_xml;
+
+/* For backwards compatibility */
+typedef fz_xml fz_xml_doc;
+
+/**
+	Parse the contents of buffer into a tree of xml nodes.
+
+	preserve_white: whether to keep or delete all-whitespace nodes.
+*/
+fz_xml *fz_parse_xml(fz_context *ctx, fz_buffer *buf, int preserve_white);
+
+/**
+	Parse the contents of buffer into a tree of xml nodes.
+
+	preserve_white: whether to keep or delete all-whitespace nodes.
+*/
+fz_xml *fz_parse_xml_stream(fz_context *ctx, fz_stream *stream, int preserve_white);
+
+/**
+	Parse the contents of an archive entry into a tree of xml nodes.
+
+	preserve_white: whether to keep or delete all-whitespace nodes.
+*/
+fz_xml *fz_parse_xml_archive_entry(fz_context *ctx, fz_archive *dir, const char *filename, int preserve_white);
+
+/**
+	Try and parse the contents of an archive entry into a tree of xml nodes.
+
+	preserve_white: whether to keep or delete all-whitespace nodes.
+
+	Will return NULL if the archive entry can't be found. Otherwise behaves
+	the same as fz_parse_xml_archive_entry. May throw exceptions.
+*/
+fz_xml *fz_try_parse_xml_archive_entry(fz_context *ctx, fz_archive *dir, const char *filename, int preserve_white);
+
+/**
+	Parse the contents of a buffer into a tree of XML nodes,
+	using the HTML5 parsing algorithm.
+*/
+fz_xml *fz_parse_xml_from_html5(fz_context *ctx, fz_buffer *buf);
+
+/**
+	Add a reference to the XML.
+*/
+fz_xml *fz_keep_xml(fz_context *ctx, fz_xml *xml);
+
+/**
+	Drop a reference to the XML. When the last reference is
+	dropped, the node and all its children and siblings will
+	be freed.
+*/
+void fz_drop_xml(fz_context *ctx, fz_xml *xml);
+
+/**
+	Detach a node from the tree, unlinking it from its parent,
+	and setting the document root to the node.
+*/
+void fz_detach_xml(fz_context *ctx, fz_xml *node);
+
+/**
+	Return the topmost XML node of a document.
+*/
+fz_xml *fz_xml_root(fz_xml_doc *xml);
+
+/**
+	Return previous sibling of XML node.
+*/
+fz_xml *fz_xml_prev(fz_xml *item);
+
+/**
+	Return next sibling of XML node.
+*/
+fz_xml *fz_xml_next(fz_xml *item);
+
+/**
+	Return parent of XML node.
+*/
+fz_xml *fz_xml_up(fz_xml *item);
+
+/**
+	Return first child of XML node.
+*/
+fz_xml *fz_xml_down(fz_xml *item);
+
+/**
+	Return true if the tag name matches.
+*/
+int fz_xml_is_tag(fz_xml *item, const char *name);
+
+/**
+	Return tag of XML node. Return NULL for text nodes.
+*/
+char *fz_xml_tag(fz_xml *item);
+
+/**
+	Return the value of an attribute of an XML node.
+	NULL if the attribute doesn't exist.
+*/
+char *fz_xml_att(fz_xml *item, const char *att);
+
+/**
+	Return the value of an attribute of an XML node.
+	If the first attribute doesn't exist, try the second.
+	NULL if neither attribute exists.
+*/
+char *fz_xml_att_alt(fz_xml *item, const char *one, const char *two);
+
+/**
+	Check for a matching attribute on an XML node.
+
+	If the node has the requested attribute (name), and the value
+	matches (match) then return 1. Otherwise, 0.
+*/
+int fz_xml_att_eq(fz_xml *item, const char *name, const char *match);
+
+/**
+	Add an attribute to an XML node.
+*/
+void fz_xml_add_att(fz_context *ctx, fz_pool *pool, fz_xml *node, const char *key, const char *val);
+
+/**
+	Return the text content of an XML node.
+	Return NULL if the node is a tag.
+*/
+char *fz_xml_text(fz_xml *item);
+
+/**
+	Pretty-print an XML tree to given output.
+*/
+void fz_output_xml(fz_context *ctx, fz_output *out, fz_xml *item, int level);
+
+/**
+	Pretty-print an XML tree to stdout. (Deprecated, use
+	fz_output_xml in preference).
+*/
+void fz_debug_xml(fz_xml *item, int level);
+
+/**
+	Search the siblings of XML nodes starting with item looking for
+	the first with the given tag.
+
+	Return NULL if none found.
+*/
+fz_xml *fz_xml_find(fz_xml *item, const char *tag);
+
+/**
+	Search the siblings of XML nodes starting with the first sibling
+	of item looking for the first with the given tag.
+
+	Return NULL if none found.
+*/
+fz_xml *fz_xml_find_next(fz_xml *item, const char *tag);
+
+/**
+	Search the siblings of XML nodes starting with the first child
+	of item looking for the first with the given tag.
+
+	Return NULL if none found.
+*/
+fz_xml *fz_xml_find_down(fz_xml *item, const char *tag);
+
+/**
+	Search the siblings of XML nodes starting with item looking for
+	the first with the given tag (or any tag if tag is NULL), and
+	with a matching attribute.
+
+	Return NULL if none found.
+*/
+fz_xml *fz_xml_find_match(fz_xml *item, const char *tag, const char *att, const char *match);
+
+/**
+	Search the siblings of XML nodes starting with the first sibling
+	of item looking for the first with the given tag (or any tag if tag
+	is NULL), and with a matching attribute.
+
+	Return NULL if none found.
+*/
+fz_xml *fz_xml_find_next_match(fz_xml *item, const char *tag, const char *att, const char *match);
+
+/**
+	Search the siblings of XML nodes starting with the first child
+	of item looking for the first with the given tag (or any tag if
+	tag is NULL), and with a matching attribute.
+
+	Return NULL if none found.
+*/
+fz_xml *fz_xml_find_down_match(fz_xml *item, const char *tag, const char *att, const char *match);
+
+/**
+	Perform a depth first search from item, returning the first
+	child that matches the given tag (or any tag if tag is NULL),
+	with the given attribute (if att is non NULL), that matches
+	match (if match is non NULL).
+*/
+fz_xml *fz_xml_find_dfs(fz_xml *item, const char *tag, const char *att, const char *match);
+
+/**
+	Perform a depth first search from item, returning the first
+	child that matches the given tag (or any tag if tag is NULL),
+	with the given attribute (if att is non NULL), that matches
+	match (if match is non NULL). The search stops if it ever
+	reaches the top of the tree, or the declared 'top' item.
+*/
+fz_xml *fz_xml_find_dfs_top(fz_xml *item, const char *tag, const char *att, const char *match, fz_xml *top);
+
+/**
+	Perform a depth first search onwards from item, returning the first
+	child that matches the given tag (or any tag if tag is NULL),
+	with the given attribute (if att is non NULL), that matches
+	match (if match is non NULL).
+*/
+fz_xml *fz_xml_find_next_dfs(fz_xml *item, const char *tag, const char *att, const char *match);
+
+/**
+	Perform a depth first search onwards from item, returning the first
+	child that matches the given tag (or any tag if tag is NULL),
+	with the given attribute (if att is non NULL), that matches
+	match (if match is non NULL). The search stops if it ever reaches
+	the top of the tree, or the declared 'top' item.
+*/
+fz_xml *fz_xml_find_next_dfs_top(fz_xml *item, const char *tag, const char *att, const char *match, fz_xml *top);
+
+/**
+	DOM-like functions for html in xml.
+*/
+
+/**
+	Return a borrowed reference for the 'body' element of
+	the given DOM.
+*/
+fz_xml *fz_dom_body(fz_context *ctx, fz_xml *dom);
+
+/**
+	Return a borrowed reference for the document (the top
+	level element) of the DOM.
+*/
+fz_xml *fz_dom_document_element(fz_context *ctx, fz_xml *dom);
+
+/**
+	Create an element of a given tag type for the given DOM.
+
+	The element is not linked into the DOM yet.
+*/
+fz_xml *fz_dom_create_element(fz_context *ctx, fz_xml *dom, const char *tag);
+
+/**
+	Create a text node for the given DOM.
+
+	The element is not linked into the DOM yet.
+*/
+fz_xml *fz_dom_create_text_node(fz_context *ctx, fz_xml *dom, const char *text);
+
+/**
+	Find the first element matching the requirements in a depth first traversal from elt.
+
+	The tagname must match tag, unless tag is NULL, when all tag names are considered to match.
+
+	If att is NULL, then all tags match.
+	Otherwise:
+		If match is NULL, then only nodes that have an att attribute match.
+		If match is non-NULL, then only nodes that have an att attribute that matches match match.
+
+	Returns NULL (if no match found), or a borrowed reference to the first matching element.
+*/
+fz_xml *fz_dom_find(fz_context *ctx, fz_xml *elt, const char *tag, const char *att, const char *match);
+
+/**
+	Find the next element matching the requirements.
+*/
+fz_xml *fz_dom_find_next(fz_context *ctx, fz_xml *elt, const char *tag, const char *att, const char *match);
+
+/**
+	Insert an element as the last child of a parent, unlinking the
+	child from its current position if required.
+*/
+void fz_dom_append_child(fz_context *ctx, fz_xml *parent, fz_xml *child);
+
+/**
+	Insert an element (new_elt), before another element (node),
+	unlinking the new_elt from its current position if required.
+*/
+void fz_dom_insert_before(fz_context *ctx, fz_xml *node, fz_xml *new_elt);
+
+/**
+	Insert an element (new_elt), after another element (node),
+	unlinking the new_elt from its current position if required.
+*/
+void fz_dom_insert_after(fz_context *ctx, fz_xml *node, fz_xml *new_elt);
+
+/**
+	Remove an element from the DOM. The element can be added back elsewhere
+	if required.
+
+	No reference counting changes for the element.
+*/
+void fz_dom_remove(fz_context *ctx, fz_xml *elt);
+
+/**
+	Clone an element (and its children).
+
+	A borrowed reference to the clone is returned. The clone is not
+	yet linked into the DOM.
+*/
+fz_xml *fz_dom_clone(fz_context *ctx, fz_xml *elt);
+
+/**
+	Return a borrowed reference to the first child of a node,
+	or NULL if there isn't one.
+*/
+fz_xml *fz_dom_first_child(fz_context *ctx, fz_xml *elt);
+
+/**
+	Return a borrowed reference to the parent of a node,
+	or NULL if there isn't one.
+*/
+fz_xml *fz_dom_parent(fz_context *ctx, fz_xml *elt);
+
+/**
+	Return a borrowed reference to the next sibling of a node,
+	or NULL if there isn't one.
+*/
+fz_xml *fz_dom_next(fz_context *ctx, fz_xml *elt);
+
+/**
+	Return a borrowed reference to the previous sibling of a node,
+	or NULL if there isn't one.
+*/
+fz_xml *fz_dom_previous(fz_context *ctx, fz_xml *elt);
+
+/**
+	Add an attribute to an element.
+
+	Ownership of att and value remain with the caller.
+*/
+void fz_dom_add_attribute(fz_context *ctx, fz_xml *elt, const char *att, const char *value);
+
+/**
+	Remove an attribute from an element.
+*/
+void fz_dom_remove_attribute(fz_context *ctx, fz_xml *elt, const char *att);
+
+/**
+	Retrieve the value of a given attribute from a given element.
+
+	Returns a borrowed pointer to the value or NULL if not found.
+*/
+const char *fz_dom_attribute(fz_context *ctx, fz_xml *elt, const char *att);
+
+/**
+	Enumerate through the attributes of an element.
+
+	Call with i=0,1,2,3... to enumerate attributes.
+
+	On return *att and the return value will be NULL if there are not
+	that many attributes to read. Otherwise, *att will be filled in
+	with a borrowed pointer to the attribute name, and the return
+	value will be a borrowed pointer to the value.
+*/
+const char *fz_dom_get_attribute(fz_context *ctx, fz_xml *elt, int i, const char **att);
+
+#endif