AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 区块链服务 区块链 BaaS 开发参考 蚂蚁区块链-合约链 Solidity 合约开发 函数概览

函数概览

更新时间：
产品详情
我的收藏

本文罗列了合约开发可调用的函数及其功能，具体函数使用信息可参见相关文档。

蚂蚁区块链合约平台在 Solidity 的基础上，添加了部分函数库的支持，包括对 JSON/XML 数据格式的构造和解析，采用预编译合约的方式加入到蚂蚁区块链合约平台中，其使用方式如下所示：

  1. pragma solidity ^0.4.23;
  3. contract test_parse {
  4.     // test json interface
  5.     function test_property_parse_json() public returns (uint)
  6.     {
  7.         string memory property_value;
  8.         int property_type;
  9.         property_value = "{\"node_config\" : {\"identity\" : \"true\",\"key_path\" : \"../../user\",\"user_keys\" : [{\"key_name\" : \"Tester001.key\",\"key_passwd\" : \"123456a\"},{\"key_name\" : \"Tester002.key\",\"key_passwd\" : \"123456a\"}],\"node\" : {\"ip\" : \"127.0.0.1\",\"port\" : 18130}}}";
  10.         property_type = 0;
  12.         // 第一步调用 property_parse
  13.         uint handler = property_parse(property_value, property_type);
  14.         // 然后获取 JSON 属性值；
  15.         test_property_get_bool(handler);
  16.         test_property_get_int(handler);
  17.         test_property_get_uint(handler);
  18.         test_property_get_string(handler);
  19.         test_property_get_array(handler);
  20.         test_property_get_list_count(handler);
  21.         // 最后释放资源
  22.         test_property_destroy(handler);
  23.         return handler;
  24.     }
  26.     // test xml interface
  27.     function test_property_parse_xml() public returns (uint)
  28.     {
  29.         string memory property_value;
  30.         int property_type;
  31.         property_value = "<?xml version=\"1.0\" encoding=\"utf-8\"?><node_config  key_path=\"../../user\"> <![CDATA[cdata]]><identity>true</identity><user_keys> <key_name>Tester001.key</key_name>  <key_passwd>123456a</key_passwd> </user_keys>  <user_keys> <key_name>Tester002.key</key_name>  <key_passwd>123456a</key_passwd> </user_keys>  <node> <ip>127.0.0.1</ip>  <port>18130</port> </node> </node_config>";
  32.         property_type = 1;
  34.         // 第一步调用 property_parse
  35.         uint handler = property_parse(property_value, property_type);
  36.         // 然后获取 XML 属性值；
  37.         test_property_get_bool(handler);
  38.         test_property_get_int(handler);
  39.         test_property_get_uint(handler);
  40.         test_property_get_string(handler);
  41.         test_property_get_array(handler);
  42.         test_property_get_cdata(handler);
  43.         test_property_get_attr(handler);
  44.         test_property_get_list_count(handler);
  45.         // 最后释放资源
  46.         test_property_destroy(handler);
  47.         return handler;
  48.     }
  49.     function test_property_destroy(uint hanlder) public returns (bool)
  50.     {
  51.         return property_destroy(hanlder);
  52.     }
  54.     function test_property_get_bool(uint hanlder) public returns (int, bool)
  55.     {
  56.         string memory path;
  57.         path = "node_config.identity";
  58.         int err;
  59.         bool ret;
  60.         (err, ret) = property_get_bool(hanlder, path);
  61.         return (err, ret);
  62.     }
  63.     function test_property_get_int(uint hanlder) public returns (int, int)
  64.     {
  65.         string memory path;
  66.         path = "node_config.node.port";
  67.         int err;
  68.         int ret;
  69.         (err, ret) = property_get_int(hanlder, path);
  70.         return (err, ret);
  71.     }
  72.     function test_property_get_uint(uint hanlder) public returns (int, uint)
  73.     {
  74.         string memory path;
  75.         path = "node_config.node.port";
  76.         int err;
  77.         uint ret;
  78.         (err, ret) = property_get_uint(hanlder, path);
  79.         return (err, ret);
  80.     }
  81.     function test_property_get_string(uint hanlder) public returns (int, string memory)
  82.     {
  83.         string memory path;
  84.         path = "node_config.node.ip";
  85.         int err;
  86.         string memory ret;
  87.         (err, ret) = property_get_string(hanlder, path);
  88.         return (err, ret);
  89.     }
  90.     function test_property_get_array(uint hanlder) public returns (int, string memory)
  91.     {
  92.         // string memory path;
  93.         // path = "node_config.user_keys[0].key_name";
  94.         int err;
  95.         string memory ret;
  96.         (err, ret) = property_get_string(hanlder, "node_config.user_keys[0].key_name");
  97.         return (err, ret);
  98.     }
  99.     function test_property_get_list_count(uint hanlder) public returns (uint) {
  100.         return property_get_list_count(hanlder, "node_config.user_keys");
  101.     }
  102.     function test_property_get_cdata(uint hanlder) public returns (int, string memory)
  103.     {
  104.         string memory path;
  105.         path = "node_config.<xmlcdata>";
  106.         int err;
  107.         string memory ret;
  108.         (err, ret) = property_get_string(hanlder, path);
  109.         return (err, ret);
  110.     }
  111.     function test_property_get_attr(uint hanlder) public returns (int, string memory)
  112.     {
  113.         string memory path;
  114.         path = "node_config.<xmlattr>.key_path";
  115.         int err;
  116.         string memory ret;
  117.         (err, ret) = property_get_string(hanlder, path);
  118.         return (err, ret);
  119.     }
  120. }
  123. contract test_write {
  124.     ///////test this interface only
  125.     function test_property_write() public returns (string memory)
  126.     {
  127.         string memory property_value;
  128.         int property_type = 0;
  130.         // 第一步调用 property_parse 
  131.         uint handler = property_parse(property_value, property_type);
  132.         // 然后设置各属性值
  133.         test_property_set_bool(handler);
  134.         test_property_set_int(handler);
  135.         test_property_set_uint(handler);
  136.         test_property_set_string(handler);
  137.         property_type = 1;
  138.         // 生成 xml/json
  139.         string memory ret = property_write(handler, property_type);
  140.         property_destroy(handler);
  141.         return ret;
  142.     }
  144.     function test_property_set_bool(uint handler) public returns (bool)
  145.     {
  146.         string memory path;
  147.         path = "a.b.c";
  148.         return property_set_bool(handler, path, true);
  149.     }
  151.     function test_property_set_int(uint handler) public returns (bool)
  152.     {
  153.         string memory path;
  154.         path = "e.f.g.h";
  155.         return property_set_int(handler, path, 0x12);
  156.     }
  158.     function test_property_set_uint(uint handler) public returns (bool)
  159.     {
  160.         string memory path;
  161.         path = "h.m.l";
  162.         return property_set_uint(handler, path, 1);
  163.     }
  164.     function test_property_set_string(uint handler) public returns (bool)
  165.     {
  166.         string memory path;
  167.         path = "a.b.g";
  168.         string memory val;
  169.         val = "testhahahaha";
  170.         return property_set_string(handler, path, val);
  171.     }
  172.     function test_property_set_cdata(uint handler) public returns (bool)
  173.     {
  174.         string memory path;
  175.         path = "zz.<xmlcdata>";
  176.         string memory val;
  177.         val = "cdata";
  178.         return property_set_string(handler, path, val);
  179.     }
  180.     function test_property_set_attr(uint handler) public returns (bool)
  181.     {
  182.         string memory path;
  183.         path = "zz.<xmlattr>.attr";
  184.         string memory val;
  185.         val = "attr";
  186.         return property_set_string(handler, path, val);
  187.     }
  188.     function test_property_remove(uint handler) public returns (bool)
  189.     {
  190.         string memory path;
  191.         path = "a.b.g";
  192.         return property_remove(handler, path);
  193.     }
  194. }
上一篇：Solidity合约编译工具下一篇：JSON与XML解析库