snarkvm_console_program/data/record/
find.rs

1// Copyright 2024 Aleo Network Foundation
2// This file is part of the snarkVM library.
3
4// Licensed under the Apache License, Version 2.0 (the "License");
5// you may not use this file except in compliance with the License.
6// You may obtain a copy of the License at:
7
8// http://www.apache.org/licenses/LICENSE-2.0
9
10// Unless required by applicable law or agreed to in writing, software
11// distributed under the License is distributed on an "AS IS" BASIS,
12// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13// See the License for the specific language governing permissions and
14// limitations under the License.
15
16use super::*;
17
18impl<N: Network> Record<N, Plaintext<N>> {
19    /// Returns the entry from the given path.
20    pub fn find<A: Into<Access<N>> + Copy + Debug>(&self, path: &[A]) -> Result<Entry<N, Plaintext<N>>> {
21        // If the path is of length one, check if the path is requesting the `owner`.
22        if path.len() == 1 && path[0].into() == Access::Member(Identifier::from_str("owner")?) {
23            return Ok(self.owner.to_entry());
24        }
25
26        // Ensure the path is not empty.
27        if let Some((first, rest)) = path.split_first() {
28            let first = match (*first).into() {
29                Access::Member(identifier) => identifier,
30                Access::Index(_) => bail!("Attempted to index into a record"),
31            };
32            // Retrieve the top-level entry.
33            match self.data.get(&first) {
34                Some(entry) => match rest.is_empty() {
35                    // If the remaining path is empty, return the top-level entry.
36                    true => Ok(entry.clone()),
37                    // Otherwise, recursively call `find` on the top-level entry.
38                    false => entry.find(rest),
39                },
40                None => bail!("Record entry `{first}` not found."),
41            }
42        } else {
43            bail!("Attempted to find record entry with an empty path.")
44        }
45    }
46}