ytnef 0.4.0

A Rust binding for libytnef. A C library for parsing the TNEF file format used by Microsoft Outlook and Exchange Server.
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use std::slice;
use std::os::raw::c_char;
use std::ffi::CStr;
use chrono::{NaiveDate, NaiveTime, NaiveDateTime};

/// Conveniently convert a C-string to a Rust string.
pub fn make_safe_string(data: *const c_char) -> String {
	unsafe {
		CStr::from_ptr(data)
			.to_string_lossy()
			.to_string()
	}
}

/// Convenient method for converting variableLength to Vec<u8>
pub fn vec_from_varlen(
	attr: ytnef_sys::variableLength
) -> Option<Vec<u8>> {
	if attr.size < 1 {
		return None;
	}

	Some(unsafe {
		slice::from_raw_parts(attr.data, attr.size as usize)
			.to_vec()
	})
}

/// Conveniently convert the variableLength native type from the ytnef library
/// to a standard Rust string.
pub fn string_from_varlen(
	attr: ytnef_sys::variableLength
) -> Option<String> {
	String::from_utf8(vec_from_varlen(attr)?).ok()
}

/// Conveniently convertthe dtr native type fro ytnef to chrono::NaiveDateTime
pub fn datetime_from_dtr(date: ytnef_sys::dtr) -> Option<NaiveDateTime> {
	let ndate = NaiveDate::from_ymd_opt(
		date.wYear as i32,
		date.wMonth as u32,
		date.wDay as u32
	)?;

	let ntime = NaiveTime::from_hms_opt(
		date.wHour as u32,
		date.wMinute as u32,
		date.wSecond as u32
	)?;

	Some(NaiveDateTime::new(ndate, ntime))
}