wasmparser/readers/component/
names.rs

1use crate::{BinaryReader, BinaryReaderError, NameMap, Result, Subsection, Subsections};
2use core::ops::Range;
3
4/// Type used to iterate and parse the contents of the `component-name` custom
5/// section in compnents, similar to the `name` section of core modules.
6pub type ComponentNameSectionReader<'a> = Subsections<'a, ComponentName<'a>>;
7
8/// Represents a name read from the names custom section.
9#[derive(Clone)]
10#[allow(missing_docs)]
11pub enum ComponentName<'a> {
12    Component {
13        name: &'a str,
14        name_range: Range<usize>,
15    },
16    CoreFuncs(NameMap<'a>),
17    CoreGlobals(NameMap<'a>),
18    CoreMemories(NameMap<'a>),
19    CoreTables(NameMap<'a>),
20    CoreModules(NameMap<'a>),
21    CoreInstances(NameMap<'a>),
22    CoreTypes(NameMap<'a>),
23    Types(NameMap<'a>),
24    Instances(NameMap<'a>),
25    Components(NameMap<'a>),
26    Funcs(NameMap<'a>),
27    Values(NameMap<'a>),
28
29    /// An unknown [name subsection](https://webassembly.github.io/spec/core/appendix/custom.html#subsections).
30    Unknown {
31        /// The identifier for this subsection.
32        ty: u8,
33        /// The contents of this subsection.
34        data: &'a [u8],
35        /// The range of bytes, relative to the start of the original data
36        /// stream, that the contents of this subsection reside in.
37        range: Range<usize>,
38    },
39}
40
41impl<'a> Subsection<'a> for ComponentName<'a> {
42    fn from_reader(id: u8, mut reader: BinaryReader<'a>) -> Result<Self> {
43        let data = reader.remaining_buffer();
44        let offset = reader.original_position();
45        Ok(match id {
46            0 => {
47                let name = reader.read_string()?;
48                if !reader.eof() {
49                    return Err(BinaryReaderError::new(
50                        "trailing data at the end of a name",
51                        reader.original_position(),
52                    ));
53                }
54                ComponentName::Component {
55                    name,
56                    name_range: offset..reader.original_position(),
57                }
58            }
59            1 => {
60                let ctor: fn(NameMap<'a>) -> ComponentName<'a> = match reader.read_u8()? {
61                    0x00 => match reader.read_u8()? {
62                        0x00 => ComponentName::CoreFuncs,
63                        0x01 => ComponentName::CoreTables,
64                        0x02 => ComponentName::CoreMemories,
65                        0x03 => ComponentName::CoreGlobals,
66                        0x10 => ComponentName::CoreTypes,
67                        0x11 => ComponentName::CoreModules,
68                        0x12 => ComponentName::CoreInstances,
69                        _ => {
70                            return Ok(ComponentName::Unknown {
71                                ty: 1,
72                                data,
73                                range: offset..offset + data.len(),
74                            });
75                        }
76                    },
77                    0x01 => ComponentName::Funcs,
78                    0x02 => ComponentName::Values,
79                    0x03 => ComponentName::Types,
80                    0x04 => ComponentName::Components,
81                    0x05 => ComponentName::Instances,
82                    _ => {
83                        return Ok(ComponentName::Unknown {
84                            ty: 1,
85                            data,
86                            range: offset..offset + data.len(),
87                        });
88                    }
89                };
90                ctor(NameMap::new(reader.shrink())?)
91            }
92            ty => ComponentName::Unknown {
93                ty,
94                data,
95                range: offset..offset + data.len(),
96            },
97        })
98    }
99}
wasmparser/readers/component/names.rs

wasmparser/readers/component/
names.rs
