libxml 0.3.1

A Rust wrapper for libxml2 - the XML C parser and toolkit developed for the Gnome project
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//!
//! Wrapper for xmlError
//!
use super::bindings;

use std::ffi::CStr;

/// Wrapper around xmlErrorPtr
#[derive(Debug)]
pub struct StructuredError(*mut bindings::_xmlError);

impl StructuredError {
  /// Wrap around and own a raw xmllib2 error structure
  pub fn from_raw(error: *mut bindings::_xmlError) -> Self {
    Self(error)
  }

  /// Human-readable informative error message
  pub fn message(&self) -> &str {
    let msg = unsafe { CStr::from_ptr((*self.0).message) };

    msg.to_str().unwrap()
  }

  /// Return a raw pointer to the underlying xmlError structure
  pub fn as_ptr(&self) -> *const bindings::_xmlError {
    self.0 // we loose the *mut since we own it
  }
}

impl Drop for StructuredError {
  fn drop(&mut self) {
    unsafe { bindings::xmlResetError(self.0) }
  }
}