솔리디티에서 매핑(mapping)은 어떻게 사용하나요?

Q1: 솔리디티에서 매핑(mapping)이란 무엇인가요?
A1: 매핑(mapping)은 키와 값의 쌍을 저장하는 데이터 구조로, 특정 키에 대응하는 값을 빠르게 조회할 수 있도록 돕습니다. 예를 들어, `mapping(address => uint)`는 주소를 키로 하여 해당 주소에 연결된 숫자 값을 저장합니다.

Q2: 매핑 선언 방법은 어떻게 되나요?
A2: 매핑은 다음과 같이 선언합니다.
```solidity
mapping(KeyType => ValueType) public name;
```
예:
```solidity
mapping(address => uint) public balances;
```
`KeyType`은 기본형, `bytes`, `string`, `address` 등이 될 수 있으며, `ValueType`은 모든 타입이 가능합니다.

Q3: 매핑의 기본 사용 사례는 무엇인가요?
A3: 대표적인 사용 사례는 사용자별 잔액 저장, 권한 부여, 토큰 소유 정보 저장 등입니다. 예를 들어, 토큰 컨트랙트에서 각 주소별 토큰 잔액을 저장할 때 사용됩니다.

Q4: 매핑에 값을 할당하는 방법은?
A4: 매핑의 키에 접근하여 값을 할당합니다.
```solidity
balances[msg.sender] = 100;
```

Q5: 매핑에서 값을 조회하는 방법은?
A5: 매핑에 키를 사용해 값에 접근합니다.
```solidity
uint balance = balances[msg.sender];
```

Q6: 매핑에 키가 존재하지 않을 때 값은 어떻게 되나요? A6: 매핑은 초기화된 값이 없으면 항상 `ValueType`의 기본값을 반환합니다. 예를 들어, `uint` 타입은 기본값 0, `bool` 타입은 기본값 false를 반환합니다.

Q7: 매핑의 이중 매핑은 어떻게 사용하나요?
A7: 매핑의 값으로 또 다른 매핑을 선언할 수 있습니다. 예:
```solidity
mapping(address => mapping(address => uint)) allowed;
```
이는 주소 A가 주소 B에게 얼마나 많은 토큰을 승인했는지 저장하는 데 사용됩니다.

Q8: 매핑에 저장된 모든 키-값 쌍을 순회할 수 있나요?
A8: 매핑은 내부적으로 키 리스트를 저장하지 않으므로 전체 키를 자동으로 순회할 수 없습니다. 키 목록은 별도 배열 등으로 관리해야 합니다.

Q9: 매핑 데이터를 삭제할 수 있나요?
A9: 키에 할당된 값을 삭제하려면 `delete` 키워드를 사용합니다.
```solidity
delete balances[msg.sender];
```
이렇게 하면 값이 기본값으로 초기화됩니다.

Q10: 매핑은 스토리지에 어떻게 저장되나요?
A10: 매핑은 솔리디티 컴파일러가 해시 함수를 이용해 키를 저장 위치로 변환하여 스토리지에 저장합니다. 따라서 매핑의 키 공간은 넓으며, 키를 알지 못하면 직접 탐색이 불가능합니다.

Q11: 매핑 선언 시 `public` 키워드를 사용하는 이유는?
A11: `public`으로 선언하면 자동으로 키 입력에 따른 값을 반환하는 getter 함수가 생성됩니다. 예를 들어, `balances(address)` 함수를 호출하여 해당 주소의 값을 조회할 수 있습니다.

Q12: 매핑의 키로 어떤 타입을 사용할 수 있나요?
A12: 매핑 키는 반드시 잔존성(fixed size)의 기본값 타입이어야 하며, 배열, 매핑, 구조체 타입은 키로 사용할 수 없습니다. 예: `address`, `uint`, `bytes32` 등이 허용됩니다.

---

위 FAQ는 솔리디티에서 매핑을 이해하고 활용하는 데 기본적인 개념과 사용법을 포함하고 있습니다.

솔리디티(Solidity)에서 매핑(mapping)은 키-값 쌍을 저장하는 데이터 구조로, 주로 상태 변수로 사용됩니다.

매핑은 해시 테이블과 유사하게 작동하며, 특정 키에 대해 값을 빠르게 조회할 수 있는 효율적인 방법을 제공합니다.

매핑은 Solidity에서 가장 많이 사용되는 데이터 구조 중 하나로, 주로 스마트 계약에서 다양한 용도로 활용됩니다.

매핑의 기본 구조 매핑은 다음과 같은 형식으로 선언됩니다: ```solidity mapping(keyType => valueType) public myMapping; ``` - `keyType`: 매핑의 키의 데이터 타입입니다.

이 타입은 기본 데이터 타입(예: `uint`, `address`, `bytes32` 등)이나 사용자 정의 구조체일 수 있습니다.

- `valueType`: 매핑의 값의 데이터 타입입니다.

이 또한 기본 데이터 타입이나 구조체일 수 있습니다.

매핑의 사용 예시 다음은 간단한 매핑 사용 예시입니다.

이 예시에서는 주소를 키로 사용하여 각 주소에 대한 잔액을 저장하는 매핑을 구현합니다.

```solidity pragma solidity ^0.8.0; contract SimpleBank { mapping(address => uint) private balances; // 예금 함수 function deposit() public payable { require(msg.value > 0, "You must send some ether"); balances[msg.sender] += msg.value; } // 잔액 조회 함수 function getBalance() public view returns (uint) { return balances[msg.sender]; } // 출금 함수 function withdraw(uint amount) public { require(balances[msg.sender] >= amount, "Insufficient balance"); balances[msg.sender] -= amount; payable(msg.sender).transfer(amount); } } ``` 매핑의 특징 1. 초기화 : 매핑은 자동으로 초기화됩니다.

즉, 매핑의 키에 대한 값이 설정되지 않은 경우, 해당 값은 기본값(예: `0` 또는 `address(0)`)으로 초기화됩니다.



2. 키의 존재 여부 확인 : 매핑은 키의 존재 여부를 직접 확인할 수 있는 방법이 없습니다.

키가 존재하는지 확인하려면 해당 키에 대한 값을 조회하고, 기본값인지 확인해야 합니다.



3. 순회 불가능 : 매핑은 순회할 수 없습니다.

즉, 매핑의 모든 키와 값을 반복(iterate)하여 조회하는 기능은 제공되지 않습니다.

이로 인해 매핑은 특정 키에 대한 값의 조회에는 효율적이지만, 전체 데이터를 조회하는 데는 적합하지 않습니다.



4. 가변성 : 매핑은 가변적이며, 키와 값을 추가하거나 수정할 수 있습니다.

그러나 매핑의 크기를 직접적으로 알 수는 없습니다.

매핑의 제한 사항 - 매핑은 배열이나 구조체와 같은 다른 데이터 구조와 결합하여 사용할 수 있지만, 매핑 자체는 배열처럼 인덱스를 사용할 수 없습니다.

- 매핑의 키는 해시값으로 저장되므로, 키의 순서가 보장되지 않습니다.

결론 매핑은 Solidity에서 매우 유용한 데이터 구조로, 스마트 계약에서 상태를 관리하는 데 필수적인 역할을 합니다.

매핑을 사용하면 특정 키에 대한 값을 효율적으로 저장하고 조회할 수 있으며, 다양한 응용 프로그램에서 활용될 수 있습니다.

그러나 매핑의 특성과 제한 사항을 이해하고 적절하게 사용하는 것이 중요합니다.