التعيينات والمصفوفات الديناميكية
نفّذ هياكل بيانات معقدة، مثل التعيينات لأزواج المفتاح والقيمة والمصفوفات الديناميكية لقوائم البيانات المرنة.
التعيينات والمصفوفات الديناميكية درس مجاني في Blockchain Smart Contracts with Solidity على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Blockchain Smart Contracts with Solidity، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Blockchain Smart Contracts with Solidity 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
Flexible Data Structures
Welcome! In Solidity, managing collections of data efficiently is key for complex smart contracts. Today, we'll dive into two powerful data structures: mappings and dynamic arrays.
These tools allow your contracts to store and retrieve information in flexible, scalable ways, essential for building robust decentralized applications.
What Are Mappings?
Think of a mapping like a dictionary or a hash table. It stores data as key-value pairs.
- You provide a unique key (like an address or an ID).
- The mapping returns the value associated with that key (like a user's balance or a name).
- Keys are not stored, only their cryptographic hash, making them very efficient for lookups.
Declaring a Mapping
To declare a mapping, you specify the key type and the value type. It's usually declared as a public state variable.
Here's how you declare a mapping to store a uint (value) for each address (key):
pragma solidity ^0.8.0;
contract MyMappings {
// A mapping from address to unsigned integer
mapping(address => uint) public balances;
// Another mapping: from uint ID to string name
mapping(uint => string) public userNames;
}Storing Data in Mappings
You can easily assign or update a value in a mapping using its key. If a key doesn't exist yet, it's created.
Let's add a function to update a user's balance:
pragma solidity ^0.8.0;
contract MyMappings {
mapping(address => uint) public balances;
function setBalance(address _user, uint _amount) public {
balances[_user] = _amount;
}
// Try calling setBalance with your address and a number,
// then check balances(yourAddress) in Remix.
}Retrieving Data from Mappings
Accessing data is straightforward: just use the key. If you try to retrieve a value for a key that hasn't been set, Solidity returns the default value for that type (e.g., 0 for uint, empty string for string, address(0) for address).
pragma solidity ^0.8.0;
contract MyMappings {
mapping(address => uint) public balances;
function setBalance(address _user, uint _amount) public {
balances[_user] = _amount;
}
function getBalance(address _user) public view returns (uint) {
return balances[_user];
}
// Deploy, call setBalance, then getBalance.
// Try getBalance for an address not yet set.
}What Are Dynamic Arrays?
A dynamic array is a list of elements of the same type, but unlike fixed-size arrays, its size can change at runtime. This makes them perfect for situations where you don't know the exact number of items upfront.
- They can grow or shrink.
- Elements are accessed by their index (starting from 0).
- They are more gas-expensive than fixed-size arrays for storage.
Declaring Dynamic Arrays
To declare a dynamic array, you simply omit the size in the square brackets. You can declare them as state variables or local variables (using memory or calldata).
Here's an example of a dynamic array of uints:
pragma solidity ^0.8.0;
contract MyArrays {
// A dynamic array of unsigned integers stored in state
uint[] public numbers;
// A dynamic array of strings (for memory use)
function createNameList() public pure returns (string[] memory) {
string[] memory names = new string[](0); // Initialize empty
return names;
}
}Adding Elements to Dynamic Arrays
The most common way to add elements to a dynamic array is using the push() method. It appends a new element to the end of the array.
array.push(): Adds a zero-initialized element.array.push(value): Adds a specific value.
pragma solidity ^0.8.0;
contract MyArrays {
uint[] public numbers;
function addNumber(uint _num) public {
numbers.push(_num); // Add _num to the end
}
function addDefault() public {
numbers.push(); // Add a 0 to the end
}
function getLength() public view returns (uint) {
return numbers.length;
}
}Accessing & Removing Elements
You can access elements by their index (starting from 0). To remove elements, you can use pop(), which removes the last element and reduces the array's length.
pragma solidity ^0.8.0;
contract MyArrays {
uint[] public data = [10, 20, 30, 40];
function getElement(uint _index) public view returns (uint) {
require(_index < data.length, "Index out of bounds");
return data[_index];
}
function removeLast() public {
data.pop(); // Removes 40
}
function getLength() public view returns (uint) {
return data.length;
}
}Advanced: Mapping of Arrays
You can combine these structures! A common pattern is a mapping where the value type is a dynamic array. This lets you associate a list of items with a key, like a user's transaction history.
Here's an example of mapping an address to a dynamic array of uints:
pragma solidity ^0.8.0;
contract UserData {
mapping(address => uint[]) public transactionHistory;
function addTransaction(address _user, uint _amount) public {
transactionHistory[_user].push(_amount);
}
function getUserTransactions(address _user) public view returns (uint[] memory) {
return transactionHistory[_user];
}
// Add a few transactions for your address, then view them.
}Check Your Understanding
Consider the following Solidity code snippet:
pragma solidity ^0.8.0;
contract DataStructures {
mapping(address => uint) public scores;
uint[] public participants;
function recordScore(address _player, uint _score) public {
if (scores[_player] == 0) {
participants.push(_player);
}
scores[_player] = _score;
}
function getParticipantCount() public view returns (uint) {
return participants.length;
}
}If recordScore(0xabc..., 100) is called, then recordScore(0xdef..., 200), and finally recordScore(0xabc..., 150), what will getParticipantCount() return?
Recap: Mappings & Dynamic Arrays
You've learned about two essential data structures in Solidity:
- Mappings: Efficient key-value stores, great for associating data with unique identifiers like addresses. They return default values for unset keys.
- Dynamic Arrays: Flexible lists that can grow or shrink in size using
push()andpop(), ideal when the number of items isn't fixed.
Mastering these will significantly enhance your ability to design robust and scalable smart contracts!
الأسئلة الشائعة
هل درس «التعيينات والمصفوفات الديناميكية» مجاني؟
نعم — نص درس «التعيينات والمصفوفات الديناميكية» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Blockchain Smart Contracts with Solidity، انتقل إلى CoddyKit PRO. تتضمن دورة Blockchain Smart Contracts with Solidity 4 دروس في المجموع.
ماذا ستتعلم في «التعيينات والمصفوفات الديناميكية»؟
نفّذ هياكل بيانات معقدة، مثل التعيينات لأزواج المفتاح والقيمة والمصفوفات الديناميكية لقوائم البيانات المرنة. تتمرن على Blockchain Smart Contracts with Solidity مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Blockchain Smart Contracts with Solidity؟
لا تُشترط خبرة سابقة. Blockchain Smart Contracts with Solidity على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.
كم من الوقت يستغرق درس «التعيينات والمصفوفات الديناميكية»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Blockchain Smart Contracts with Solidity هذا؟
نعم. كل درس في Blockchain Smart Contracts with Solidity يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- متغيرات الحالة وتخطيط التخزين
- التعيينات والمصفوفات الديناميكية
- الأحداث وتسجيل البيانات
- خانات التخزين وتحسين استهلاك الغاز