gvas 0.11.0

Crate for parsing UE4 gvas save files.
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

use std::io::{Cursor, Read, Seek, Write};

use byteorder::{LittleEndian, ReadBytesExt, WriteBytesExt};

use crate::{cursor_ext::ReadExt, cursor_ext::WriteExt, error::Error};

use super::{impl_read, impl_read_header, impl_write, PropertyOptions, PropertyTrait};

/// A property that holds a name.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", serde_with::skip_serializing_none)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct NameProperty {
    /// Array Index
    #[cfg_attr(feature = "serde", serde(skip_serializing_if = "is_zero"))]
    #[cfg_attr(feature = "serde", serde(default))]
    pub array_index: u32,
    /// Name value.
    pub value: Option<String>,
}

#[cfg(feature = "serde")]
fn is_zero(num: &u32) -> bool {
    *num == 0
}

impl From<&str> for NameProperty {
    #[inline]
    fn from(value: &str) -> Self {
        NameProperty::from(Some(value.into()))
    }
}

impl From<String> for NameProperty {
    #[inline]
    fn from(value: String) -> Self {
        Self::from(Some(value))
    }
}

impl From<Option<String>> for NameProperty {
    #[inline]
    fn from(value: Option<String>) -> Self {
        let array_index: u32 = 0;
        NameProperty { array_index, value }
    }
}

impl NameProperty {
    impl_read!(array_index);
    impl_read_header!(array_index);

    #[inline]
    fn read_body<R: Read + Seek>(cursor: &mut R, array_index: u32) -> Result<Self, Error> {
        let value = cursor.read_fstring()?;
        Ok(NameProperty { array_index, value })
    }
}

impl PropertyTrait for NameProperty {
    impl_write!(NameProperty, array_index);

    #[inline]
    fn write_body<W: Write>(
        &self,
        cursor: &mut W,
        _options: &mut PropertyOptions,
    ) -> Result<usize, Error> {
        let len = cursor.write_fstring(self.value.as_deref())?;
        Ok(len)
    }
}