wasmparser/readers/core/imports.rs
1/* Copyright 2018 Mozilla Foundation
2 *
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15
16use crate::{
17 BinaryReader, ExternalKind, FromReader, GlobalType, MemoryType, Result, SectionLimited,
18 TableType, TagType,
19};
20
21/// Represents a reference to a type definition in a WebAssembly module.
22#[derive(Debug, Clone, Copy, Eq, PartialEq)]
23pub enum TypeRef {
24 /// The type is a function.
25 ///
26 /// The value is an index into the type section.
27 Func(u32),
28 /// The type is a table.
29 Table(TableType),
30 /// The type is a memory.
31 Memory(MemoryType),
32 /// The type is a global.
33 Global(GlobalType),
34 /// The type is a tag.
35 ///
36 /// This variant is only used for the exception handling proposal.
37 ///
38 /// The value is an index in the types index space.
39 Tag(TagType),
40}
41
42/// Represents an import in a WebAssembly module.
43#[derive(Debug, Copy, Clone, Eq, PartialEq)]
44pub struct Import<'a> {
45 /// The module being imported from.
46 pub module: &'a str,
47 /// The name of the imported item.
48 pub name: &'a str,
49 /// The type of the imported item.
50 pub ty: TypeRef,
51}
52
53/// A reader for the import section of a WebAssembly module.
54pub type ImportSectionReader<'a> = SectionLimited<'a, Import<'a>>;
55
56impl<'a> FromReader<'a> for Import<'a> {
57 fn from_reader(reader: &mut BinaryReader<'a>) -> Result<Self> {
58 Ok(Import {
59 module: reader.read()?,
60 name: reader.read()?,
61 ty: reader.read()?,
62 })
63 }
64}
65
66impl<'a> FromReader<'a> for TypeRef {
67 fn from_reader(reader: &mut BinaryReader<'a>) -> Result<Self> {
68 Ok(match reader.read()? {
69 ExternalKind::Func => TypeRef::Func(reader.read_var_u32()?),
70 ExternalKind::Table => TypeRef::Table(reader.read()?),
71 ExternalKind::Memory => TypeRef::Memory(reader.read()?),
72 ExternalKind::Global => TypeRef::Global(reader.read()?),
73 ExternalKind::Tag => TypeRef::Tag(reader.read()?),
74 })
75 }
76}