【Solidity】第4章第4回:マッピングと構造体の組み合わせ

本記事では、Solidityにおけるマッピング(mapping)と構造体(struct)を組み合わせて使用する方法について詳しく解説します。これにより、複雑なデータ管理を効率的に実現できます。
0. 記事の概要
この記事を読むメリット
- データ管理の効率化:マッピングと構造体を組み合わせることで、複雑なデータを簡潔に管理できます。
- スマートコントラクトの実践力向上:現場で役立つ高度なデータ構造の活用法を学べます。
- 応用力の獲得:マッピングと構造体を使った実践例で応用力を高めます。
この記事で学べること
- マッピングと構造体の組み合わせの基本
- 実践的なコントラクト例
- よくあるエラーとその解決策
1. マッピングと構造体の基本

1.1 マッピングと構造体の概要
マッピングはキーと値のペアを効率的に管理するデータ構造で、構造体は複数のデータ型をまとめることができるデータ構造です。これらを組み合わせることで、キーに紐づけて複数のデータを管理できます。
1.2 基本構文
// マッピングと構造体の基本例
contract MappingStructExample {
struct User {
string name;
uint256 age;
}
mapping(address => User) public users;
function addUser(string memory _name, uint256 _age) public {
users[msg.sender] = User(_name, _age);
}
function getUser(address _userAddress) public view returns (string memory, uint256) {
User memory user = users[_userAddress];
return (user.name, user.age);
}
}
動作解説
このコードでは、users
マッピングでアドレスごとにユーザー情報を管理しています。関数addUser
でデータを追加し、getUser
でデータを取得できます。
2. 実践例:所有者と商品情報の管理

2.1 商品情報を管理するコントラクト
// 商品情報を管理する例
contract ProductManagement {
struct Product {
string name;
uint256 price;
bool isAvailable;
}
mapping(address => Product) public products;
function addProduct(string memory _name, uint256 _price) public {
products[msg.sender] = Product(_name, _price, true);
}
function updateAvailability(bool _isAvailable) public {
require(bytes(products[msg.sender].name).length > 0, "商品が登録されていません");
products[msg.sender].isAvailable = _isAvailable;
}
function getProduct(address _owner) public view returns (string memory, uint256, bool) {
Product memory product = products[_owner];
return (product.name, product.price, product.isAvailable);
}
}
動作解説
このコントラクトでは、アドレスごとに商品情報を管理します。addProduct
で新しい商品を追加し、updateAvailability
で商品が利用可能かどうかを更新します。
3. よくあるエラーとその解決策
3.1 データの未登録エラー
マッピングで未登録のキーにアクセスすると、デフォルト値が返されます。このため、データの登録を確認するロジックを追加する必要があります。
3.2 データの上書き
マッピングの値は簡単に上書きされるため、更新時には既存データの有無をチェックすることが推奨されます。
4. 練習問題

以下の課題に挑戦してみましょう:
- ユーザーに複数の商品を登録できるようにマッピングの構造を拡張してください。
- 登録された商品の合計金額を計算する関数を追加してください。
5. まとめ
本記事では、Solidityにおけるマッピングと構造体を組み合わせたデータ管理手法について学びました。この手法を活用することで、複雑なデータ構造を効率的に管理するスマートコントラクトを作成できます。