FarelDB 第2章 第13讲 键值对命令 字符串操作类(string) 之 msetnx key

FarelDB 键值对命令 字符串操作类(string) 之 MSETNX KEY_NAME

当且仅当所有给定键都不存在时， 为所有给定键设置值。
即使只有一个给定键已经存在， MSETNX 命令也会拒绝执行对所有键的设置操作。
MSETNX 是一个原子性(atomic)操作， 所有给定键要么就全部都被设置， 要么就全部都不设置。

语法

FarelDB 127.0.0.1：6800 > MSETNX key1 value1 key2 value2 .. keyN valueN 

返回值

当所有 key 都成功设置，返回 1 。 如果任何一个 key 已存在，则设置失败，返回 0 。

命令实例

打开一个命令行窗口，启动FarelDB服务端，再打开一个命令行窗口，启动FarelDB客户端，输入以下命令：

FarelDb 127.0.0.1:6800 > msetnx name "leo" age "19" sex "male"
1
(0 ms)
FarelDb 127.0.0.1:6800 > mget name age sex
1) "leo"
2) "19"
3) "male"
(0 ms)
# MSET 的给定 key 当中有已存在的 key
FarelDb 127.0.0.1:6800 > msetnx name "tom" age "20" sex "female"     # name 键已经存在，操作失败
0
(0 ms)
FarelDb 127.0.0.1:6800 > msetnx name "tom" age "20" sex "female" language "English" # name 键已经存在，操作失败
0
(0 ms)
FarelDb 127.0.0.1:6800 > get language   # 因为 MSET 是原子性操作，language 没有被设置
(nil)
(0 ms)
FarelDb 127.0.0.1:6800 > get name      # name 也没有被修改
"leo"
(0 ms)

命令使用特别说明

无

---

API 说明

函数原型

FarelDbKvRes* queryKv(std::string Command)

输入参数说明

输入参数	描述	可选
Command	MSET key1 value1 key2 value2 … keyN 语法字符串	否

返回参数说明

调用成功返回

返回参数	值	含义
FarelDbKvRes->errorInfos.size()	0	调用成功，无错误信息

调用异常返回

返回参数	值	含义
FarelDbKvRes->errorInfos.size()	大于0	调用失败，errorInfos对象数组包含1个或多个错误信息
FarelDbKvRes->errorInfos[0]->resCode	大于0的数值	调用失败，返回错误代码
FarelDbKvRes->errorInfos[0]->resInfo	非空字符串	调用失败，返回错误信息字符串

返回数据获取方法

FarelDbKvRes* queryKv(std::string stringCommand)接口调用成功后，接口将不同种类命令需要返回的不同种类数据集存储在FarelDbKvRes的众多不同子类对象中返回给调用者，调用者可以根据不同的命令类型将接口返回的父类FarelDbKvRes指针转换成具体存储返回数据集的子类对象指针来取得数据集，具体获取方法，请参考下面的样例代码。

时间复杂度

O(logN)

样例代码

#include <iostream>
#include <functional>
#include <memory>
#include "fareldb_connection.h"
using namespace std;
using namespace fareldb_connection;
 
int main(int argc,char *argv[])
{ 	
	//创建连接
	FarelDbConnection  conn;

	//连接
	tuple<int, string> resConn = conn.connect("127.0.0.1", 6800, "root", "root");
	
	//连接失败
	if (0 != get<0>(resConn))
	{
		printf("调用失败，错误代码：%d : 错误信息：%s\n", get<0>(resConn), get<1>(resConn).c_str());
		return;
	}

	//连接成功

	// MSETNX key value[key value ...] 命令在指定的 key 不存在时，为 key 设置指定的值。若任何一个key存在，则返回错误
	string kvCommand = u8"msetnx key1 val1 key2 val2 key3 val3";//命令需要使用utf8字符串

	//执行命令
	std::shared_ptr<FarelDbKvRes> res(conn.queryKv(kvCommand));

	//判断执行命令返回是否失败
	if (res->errorInfos.size() == 0)
	{
		printf("调用成功: %s (如果所有key都不存在，则成功) \n", kvCommand.c_str());
	}
	else
	{
		printf("调用失败，(任何一个key存在，则失败) 错误代码:%d  ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
	}
}

补充说明

无