二solidity 基础进阶(2.1)—— library 库合约《实战NFT web3 solidity(新版本0.8.+)》
Posted 1_bit
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了二solidity 基础进阶(2.1)—— library 库合约《实战NFT web3 solidity(新版本0.8.+)》相关的知识,希望对你有一定的参考价值。
《web3 solidity0.8.+版本(持续更新新版本内容) 基础到实战NFT开发》会及时更新新版本 solidity 内容,以及完成最终的 NFT 实战商业项目部分。
注:由于是付费专栏内容,若有错误请及时联系@1_bit,博客链接:https://blog.csdn.net/A757291228 ,或在文章下留言,收到后将会对错误进行改正,若是版本更新导致的问题也希望大家对错误进行提交,尽力去保证付费用户该得到的权益。
文章目录可查看:目录(文章更新中…)
更新内容将会在目录中更新…
友情提示:本系列文章读者最好学过一门编程语言,面向对象语言更佳,文章所有代码将会完整贴出。
一、库 library
solidity 中的 library 库合约跟合约编写方式类似,在 solidity 中的作用是减少代码冗余,减少重复代码;在 library 合约中,不能创建状态遍历,你可以理解为库合约 library 就是一个“流水线”,不提供“原料”只做流程处理。
一个 library 不能够被继承,也不能够接受以太,我们只编写流程代码,并且使用 library 还可以节省 gas,毕竟代码减少了对吧?
二、库 library 合约示例
首先我们在 remix 上创建一个合约,名为 LibraryDemo:
在这个合约中新建一个合约:
// SPDX-License-Identifier:MIT
pragma solidity ^0.8.7;
library LibraryDemo
从以上代码中可以看出,创建一个 库合约 非常简单,只需要把以前所使用的合约关键字 contract 换成 library 即可。
接着在这个结构体中创建一个 struct 结构体,并且给与一个成员变量 map,是一个 mapping 映射:
struct structData
mapping(string=>uint32) map;
在这个时候就有同学疑问了,不是说不能创建状态变量吗?为什么这里创建了一个结构体?
如果没有这个疑问的同学,很好,你这点是理解的,其实在这里创建的是一个结构体,表示一种数据“结构”,从本质上来说这个结构体就是一个“数据结构”,此处我们并没有把这个结构体进行“实例化”之类的操作,所以它只是一种抽象的数据结构,即使我在内部创建了一个 map 映射,那也只是表示一种数据结构,就像你在一个 function 中创建一个 uint 类型的变量,那么这个变量也是属于 memory 对吧?
既然已经说清楚以上的结构体了,那么接下来我们在这个 library 中创建个方法:
function insertData(structData storage self,string memory _name,uint32 _age)public
self.map[_name]=_age;
以上这个方法叫做 insertData,顾名思义就是往里面插值,那往哪里插值呢?咱们可以看参数 structData storage self
,这个参数是用 storage 进行修饰的,表示的是传入地址,那么传入地址过来的数据修改了,那么就表示本身进行了修改,所以此时所需要把值插入到的变量那应该就是 self,这个 self 是这个 structData 结构体类型的变量;接着还有两个参数,分别是 _name 和 _age,由于 string 是一个可变长的参,在这里使用了 memory 对其进行修饰。
这个函数的函数体中,solidity 代码 self.map[_name]=_age;
表示给结构体中的 map 赋值,这里使用 点运算符进行操作。
那么接下来就创建一个取值的方法:
function get(structData storage self,string memory _name)view public returns(uint32)
return self.map[_name];
这个代码应该没啥好解释的吧?跟之前的类似,多了一个 view 对其进行修饰,毕竟是读数据,返回一个 uint32 的数据。
以上完整的 library 合约代码如下:
// SPDX-License-Identifier:MIT
pragma solidity ^0.8.7;
library LibraryDemo
struct structData
mapping(string=>uint32) map;
function insertData(structData storage self,string memory _name,uint32 _age)public
self.map[_name]=_age;
function get(structData storage self,string memory _name)view public returns(uint32)
return self.map[_name];
三、调用 library 示例
接着开始 调用 library的示例,在同 sol 文件下编写一个合约名叫 CallLib:
contract CallLib
在合约中创建一个变量为 library 合约中 结构体 structData 的类似变量:
LibraryDemo.structData private libObj;
在这里直接使用合约名用点运算符可获取到合约内的内容,在这里 LibraryDemo.structData 就表示这个库合约中的 structData 结构体类型,并且修饰为这个名为 libObj 的结构体变量为 私有 private 。(注意不能设置为 public,规定为 private )
若设置这个库合约的变量 libObj 为 public 即可得到一个报错:
接着就是创建两个方法了(上图已经暴露),一个叫做 insertName 另一个叫做 get。insertName 传入两个参数,一个是名另一个是年龄,在这里_name 参数是 string 变长类型所以使用了 memory,接着直接使用 library 合约 LibraryDemo 调用 insertData 方法,传入参数即可:
LibraryDemo.insertData(libObj,_name,_age);
在这里 libObj 为创建的合约结构体类型变量,在库合约中是 storage 修饰的,所以是传址,即在库合约中修改了值在 CallLib 合约中也会发生改变。
随后就是 get 方法:
function get(string memory _name)view public returns(uint32)
return LibraryDemo.get(libObj,_name);
get 方法接收一个字符串类型的 _name 变量,之后返回年龄,所以 returns 所指定的返回类型为 uint32,接下来直接使用 库合约调用 get 方法传入名称即可。
最后部署合约,调用方法传入值即可:
多个值之间使用逗号隔开。
这第三点的完整代码如下:
// SPDX-License-Identifier:MIT
pragma solidity ^0.8.7;
library LibraryDemo
struct structData
mapping(string=>uint32) map;
function insertData(structData storage self,string memory _name,uint32 _age)public
self.map[_name]=_age;
function get(structData storage self,string memory _name)view public returns(uint32)
return self.map[_name];
contract CallLib
LibraryDemo.structData private libObj;
function insertName(string memory _name,uint32 _age)public
LibraryDemo.insertData(libObj,_name,_age);
function get(string memory _name)view public returns(uint32)
return LibraryDemo.get(libObj,_name);
四、调用 library sol
除了在一个sol文件中直接调用库合约,还可以直接调用合约文件,而在现实中往往也是这样做的,毕竟所有东西写在一个文件内看着还是非常头疼的。
接着我们创建一个sol 文件叫做CallLib.sol:
随后使用 import 关键字对文件进行引用:
import "./LibraryDemo.sol";
其中路径 "./"
表示当前路径下,若你直接使用 "/"
则表示根目录下。使用 import 在其后面写上所需要引入的文件路径即可。
接着代码编写与原来一致,完整的 CallLib.sol 代码如下:
// SPDX-License-Identifier:MIT
pragma solidity ^0.8.7;
import "./LibraryDemo.sol";
contract CallLib
LibraryDemo.structData private libObj;
function insertName(string memory _name,uint32 _age)public
LibraryDemo.insertData(libObj,_name,_age);
function get(string memory _name)view public returns(uint32)
return LibraryDemo.get(libObj,_name);
编译没问题后部署后调用:
以上是关于二solidity 基础进阶(2.1)—— library 库合约《实战NFT web3 solidity(新版本0.8.+)》的主要内容,如果未能解决你的问题,请参考以下文章
二solidity 基础进阶(2.1)—— library 库合约《实战NFT web3 solidity(新版本0.8.+)》