Merge pull request #61 from WeBankBlockchain/dev

智能合约代码贡献第二期

Author: dalaocu

.gitignore

@@ -11,7 +11,7 @@
 
 | 依赖软件 | 说明 |备注|
 | --- | --- | --- |
-| Solidity | 0.4.25 | |
+| Solidity | 0.4.25-0.6.10 | |
 | Git | 下载需要使用Git | |
 
 ## 文档

LICENSE

@@ -0,0 +1,94 @@
+pragma solidity^0.4.25;
+import "./LibSafeMathForUint256Utils.sol";
+
+library LibSafeMathForFloatUtils {
+    using LibSafeMathForUint256Utils for uint256;
+    
+    /*
+        fmul：浮点数乘法
+        a：被乘数
+        dA：被乘数a的精度，若a = 1234，dA=2，实际表示浮点型数为12.34 
+        b：乘数
+        dB：乘数的精度
+        返回值：乘法后的结果，精度值(以被乘数精度为准)
+        100.01 * 100.01 = 10000.0001 => 10000.00 
+    */
+    function fmul(uint256 a, uint8 dA, uint256 b, uint8 dB) internal pure returns (uint256 c, uint8 decimals) {
+        decimals = dA;
+        c = a.mul(b).div(10 ** uint256(dB));
+    }
+    
+    /*
+        fdiv：浮点数除法
+        a：被除数
+        dA：被除数a的精度，若a = 1234，decimalsA=2，实际表示浮点型数为12.34 
+        b：除数
+        dB：除数的精度
+        返回值：除法后的结果，精度值(以被除数精度为准)
+        10000.00 / 100.00 = 100.00
+    */
+    function fdiv(uint256 a, uint8 dA, uint256 b, uint8 dB) internal pure returns (uint256 c, uint8 decimals)  {
+        decimals = dA;
+        if(dA == dB) {
+            c = a.mul(10 ** uint256(dA)).div(b);
+        }
+        else if(dA > dB) {
+            //第一个参数精度更大
+            b = b.mul(10 **uint256(dA - dB) );
+            c = a.mul(10 ** uint256(dA)).div(b);
+        } else {
+            //第2个参数精度更大
+            b = b.div(10 ** uint256(dB - dA) );
+            c = a.mul(10 ** uint256(dA)).div(b);
+        }
+    }
+    
+    /*
+        fadd：浮点数加法
+        a：加数a
+        dA：加数a的精度，若a = 1234，decimalsA=2，实际表示浮点型数为12.34 
+        b：加数b
+        dB：加数b的精度
+        返回值：加法后的结果，精度值(以第1个参数精度为准)
+    */
+    function fadd(uint256 a, uint8 dA, uint256 b, uint8 dB) internal pure returns (uint256 c, uint8 decimals)  {
+        decimals = dA;
+        if(dA == dB) {
+            c = a.add(b);
+        }
+        else if(dA > dB) {
+            //第一个参数精度更大
+            b = b.mul(10 **uint256(dA - dB) );
+            c = a.add(b);
+        } else {
+            //第2个参数精度更大
+            b = b.div(10 ** uint256(dB - dA) );
+            c = a.add(b);
+        }
+    }
+    
+    /*
+        fsub：浮点数减法
+        a：被减数
+        dA：被减数a的精度，若a = 1234，decimalsA=2，实际表示浮点型数为12.34 
+        b：减数
+        dB：减数b的精度
+        返回值：减法后的结果，精度值(以第1个参数精度为准)
+    */
+    function fsub(uint256 a, uint8 dA, uint256 b, uint8 dB) internal pure returns (uint256 c, uint8 decimals)  {
+        decimals = dA;
+        if(dA == dB) {
+            c = a.sub(b);
+        } else if (dA > dB) {
+            c = a.sub(b.mul(10 ** uint256(dA - dB)));
+        } else {
+            c = a.sub(b.div(10 ** uint256(dB - dA)));
+        }
+        
+    }
+    
+    
+}
+
+    
+    

README.md

@@ -0,0 +1,115 @@
+pragma solidity ^0.4.25;
+/**
+* @author wpzczbyqy <[email protected]>
+* @title  uint256类型 二维数组操作
+* 提供二维数组的操作，增加新元素，删除元素，修改值，查找值，合并扩展数组等
+**/
+
+library Lib2DArrayForUint256 {
+    /**
+    *@dev 二维数组中增加一个数组元素
+    *@param  array uint256类型二维数组
+    *@param  value uint256类型一维数组
+    **/
+    function addValue(uint256[][] storage array,uint256[] value) internal{
+        require(value.length > 0, "Empty Array: can not add empty array");
+        array.push(value);
+    }
+
+    /**
+    *@dev    查找二维数组中指定位置的值
+    *@param  array uint256类型二维数组
+    *@param  row   值所在的行
+    *@param  col   值所在的列
+    *@return uint256 返回查找的值
+    **/
+    function getValue(uint256[][] storage array, uint256 row, uint256 col) internal returns (uint256) {
+        if(array.length == 0){
+            return 0;
+        }
+        require(row < array.length,"Row: index out of bounds");
+        require(col < array[row].length, "Col: index out of bounds");
+        return array[row][col];
+    }
+
+    /**
+    *@dev    修改二维数组中指定位置的值
+    *@param  array uint256类型二维数组
+    *@param  row   值所在的行
+    *@param  col   值所在的列
+    *@param  val   修改指定位置的值为val
+    *@return uint256[][] 返回修改后的数组
+    **/
+    function setValue(uint256[][] storage array, uint256 row, uint256 col, uint256 val) internal returns (uint256[][]) {
+        if(array.length == 0){
+            return;
+        }
+
+        require(row < array.length,"Row: index out of bounds");
+        require(col < array[row].length, "Col: index out of bounds");
+        array[row][col] = val;
+        return array;
+    }
+
+    /**
+    *@dev    修改二维数组中指定位置的值
+    *@param  array uint256类型二维数组
+    *@param  row   值所在的行
+    *@param  col   值所在的列
+    *@param  val   修改指定位置的值为val
+    *@return uint256[][] 返回修改后的数组
+    **/
+    function firstIndexOf(uint256[][] storage array, uint256 val) internal returns (bool, uint256, uint256) {
+        uint256  row;
+        uint256  col;
+        if (array.length == 0) {
+            return (false, 0, 0);
+        }
+        for(uint256 i = 0; i < array.length; i++) {
+            for(uint256 j = 0; j < array[i].length; j++) {
+                if(array[i][j] == val){
+                    row = i;
+                    col = j;
+                    return (true, row, col);
+                }
+            }
+        }
+        return (false, 0, 0);
+    }
+
+    /**
+    *@dev    删除二维数组中的某个数组元素
+    *@param  array uint256类型二维数组
+    *@param  index 删除第index个数组元素
+    *@return uint256[][] 返回修改后的数组
+    **/
+    function removeByIndex(uint256[][] storage array, uint256 index) internal returns(uint256[][]) {
+        require(index < array.length, "Index: index out of bounds");
+        delete array[index];
+
+        while(index < array.length -1) {
+            delete array[index];
+            for(uint256 i = 0; i < array[index + 1].length; i++){
+                array[index].push(array[index + 1][i]);
+            }
+            index++;
+        }
+        array.length--;
+        return array;
+    }
+
+    /**
+    *@dev    合并两个二维数组
+    *@param  array1 uint256类型二维数组
+    *@param  array2 uint256类型二维数组
+    *@return uint256[][] 返回合并后的数组
+    **/
+    function extend(uint256[][] storage array1, uint256[][] storage array2) internal returns(uint256[][]){
+        require(array2.length > 0, "Extend: can not extend empty array");
+
+        for(uint256 i = 0; i < array2.length; i++){
+            array1.push(array2[i]);
+        }
+        return array1;
+    }
+}