eccodes 0.14.0

Unofficial high-level Rust bindings of the latest ecCodes release
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

#![allow(non_camel_case_types)]
#![allow(clippy::module_name_repetitions)]

use std::ffi::{CStr, CString};

use eccodes_sys::{codes_handle, codes_keys_iterator};

use tracing::instrument;

use crate::{errors::CodesError, intermediate_bindings::error_code_to_result, pointer_guard};

#[instrument(level = "trace")]
pub unsafe fn codes_keys_iterator_new(
    handle: *mut codes_handle,
    flags: u32,
    namespace: &str,
) -> Result<*mut codes_keys_iterator, CodesError> {
    unsafe {
        pointer_guard::non_null!(handle);

        let namespace = CString::new(namespace).unwrap();

        let kiter =
            eccodes_sys::codes_keys_iterator_new(handle, u64::from(flags), namespace.as_ptr());

        if kiter.is_null() {
            return Err(CodesError::KeysIteratorFailed);
        }

        Ok(kiter)
    }
}

#[instrument(level = "trace")]
pub unsafe fn codes_keys_iterator_delete(
    keys_iterator: *mut codes_keys_iterator,
) -> Result<(), CodesError> {
    unsafe {
        if keys_iterator.is_null() {
            return Ok(());
        }

        let error_code = eccodes_sys::codes_keys_iterator_delete(keys_iterator);
        error_code_to_result(error_code)?;

        Ok(())
    }
}

pub unsafe fn codes_keys_iterator_next(
    keys_iterator: *mut codes_keys_iterator,
) -> Result<bool, CodesError> {
    unsafe {
        pointer_guard::non_null!(keys_iterator);

        let next_item_exists = eccodes_sys::codes_keys_iterator_next(keys_iterator);

        Ok(next_item_exists == 1)
    }
}

pub unsafe fn codes_keys_iterator_get_name(
    keys_iterator: *mut codes_keys_iterator,
) -> Result<String, CodesError> {
    unsafe {
        pointer_guard::non_null!(keys_iterator);

        let name_pointer = eccodes_sys::codes_keys_iterator_get_name(keys_iterator);

        let name_c_str = CStr::from_ptr(name_pointer);
        let name_str = name_c_str.to_str()?;
        let name_string = name_str.to_owned();

        Ok(name_string)
    }
}