如何在Solidity（区块链）中遍历mapping并返回指定数据

Solidity里的mapping是哈希表实现的，本身没有长度属性，也不支持直接遍历。要实现遍历addressInfo并返回地址、ownerName和balance，你需要额外维护一个数组来记录所有存入mapping的地址，具体实现如下：

步骤1：扩展合约数据结构 #

在原有合约里添加两个额外成员：

• 一个数组存储所有已添加的地址
• 一个辅助mapping标记地址是否已在数组中（避免重复添加）

步骤2：维护地址数组同步 #

在更新addressInfo的函数里，确保新地址被添加到数组，已存在的地址不重复加入。

步骤3：编写遍历函数 #

通过遍历地址数组，逐个从addressInfo中取出对应数据，打包返回。

完整合约示例 #

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract AddressManager {
    struct AddressInfo {
        string ownerName;
        uint256 balance;
        bool allowed;
    }

    // 原有mapping
    mapping(address => AddressInfo) public addressInfo;
    // 存储所有已添加的地址
    address[] public allAddresses;
    // 标记地址是否已加入数组，避免重复
    mapping(address => bool) public isAddressAdded;

    // 添加或更新地址信息
    function addAddressInfo(address addr, string calldata name, uint256 balance, bool allowed) external {
        // 更新mapping中的数据
        addressInfo[addr] = AddressInfo(name, balance, allowed);
        
        // 如果地址还没加入数组，就添加进去
        if (!isAddressAdded[addr]) {
            allAddresses.push(addr);
            isAddressAdded[addr] = true;
        }
    }

    // 遍历并返回所有地址、ownerName和balance
    function getAllAddressData() external view returns (address[] memory, string[] memory, uint256[] memory) {
        uint256 count = allAddresses.length;
        // 初始化三个数组存结果
        address[] memory addresses = new address[](count);
        string[] memory ownerNames = new string[](count);
        uint256[] memory balances = new uint256[](count);

        // 遍历地址数组，填充数据
        for (uint256 i = 0; i < count; i++) {
            address addr = allAddresses[i];
            AddressInfo storage info = addressInfo[addr];
            
            addresses[i] = addr;
            ownerNames[i] = info.ownerName;
            balances[i] = info.balance;
        }

        return (addresses, ownerNames, balances);
    }
}

关键说明 #

• addAddressInfo函数：更新addressInfo的同时维护allAddresses数组，确保每个地址只被添加一次，避免数组冗余。
• getAllAddressData函数：遍历allAddresses数组，分别提取地址、ownerName和balance，以三个数组的形式返回（如果使用Solidity 0.8.18+版本，也可以定义包含这三个字段的结构体，直接返回结构体数组）。

内容的提问来源于stack exchange，提问作者Arthur Guilherme