MAP 操作相关函数¶

API

string MAP_GET mapName, key
int MAP_HAS mapName, key
int MAP_SET mapName, key, value
int MAP_REMOVE mapName, key
int MAP_SIZE mapName
int MAP_CLEAR mapName

操作已保存的 MAP（键值对映射数组，或称「字典」，Dictionary<string,string>）的一系列函数。

• MAP_GET：在名为 mapName 的 MAP 中取出 key 对应的值。指定的 MAP 不存在，或没有找到该 key 时，返回空字符串。不会抛出异常，如有需要请使用 MAP_HAS / MAP_EXIST 提前进行检查。
• MAP_HAS：判断名为 mapName 的 MAP 中是否存在指定的 key。如果存在，返回 1，否则返回 0。若指定的 MAP 本身就不存在，返回 -1。
• MAP_SET：在名为 mapName 的 MAP 中覆写 key 对应的值（value）；若指定的 key 不存在，自动添加 key；成功设置新值后返回 1。若指定的 MAP 本身就不存在，返回 -1。
• MAP_REMOVE：在名为 mapName 的 MAP 中删除 key 对应的键值对，返回 1。若指定的 MAP 本身就不存在，返回 -1。
• MAP_SIZE：返回名为 mapName 的 MAP 中保存的键值对数量。若指定的 MAP 本身就不存在，返回 -1。
• MAP_CLEAR：删除名为 mapName 的 MAP 中保存的所有键值对，返回 1。若指定的 MAP 本身就不存在，返回 -1。