目录
简介
nlohmann::basic_json::accept 是 Nlohmann JSON 库中的一个方法，它用于检查一个字符串是否可以解析为有效的 JSON。
方法的签名如下：
bool accept(const string_t& input);
其中 input 是要检查的字符串。
如果字符串可以解析为有效的 JSON，那么此方法会返回 true，否则返回 false。
以下是一个使用示例：
#include <nlohmann/json.hpp>
using json = nlohmann::json;
int main() {
std::string jsonString = R"({"key": "value"})";
std::string notJsonString = R"(Not a json string)";
bool jsonStringIsValid = json::accept(jsonString);
bool notJsonStringIsValid = json::accept(notJsonString);
std::cout << "jsonStringIsValid: " << jsonStringIsValid << '\n';
std::cout << "notJsonStringIsValid: " << notJsonStringIsValid << '\n';
return 0;
}
在这个示例中，jsonStringIsValid 会被设置为 true，因为 jsonString 是一个有效的 JSON 字符串，而 notJsonStringIsValid 会被设置为 false，因为 notJsonString 不是一个有效的 JSON 字符串。
nlohmann::basic_json::accept 官网介绍
// (1) template<typename InputType> static bool accept(InputType&& i, const bool ignore_comments = false); // (2) template<typename IteratorType> static bool accept(IteratorType first, IteratorType last, const bool ignore_comments = false);
检查输入是否为有效的 JSON。
- 从兼容的输入中读取。
- 从一对字符迭代器中读取。
迭代器的 value_type 必须是大小为 1、2 或 4 字节的整型，分别被解释为 UTF-8、UTF-16 和 UTF-32。
与 parse 函数不同，此函数在遇到无效的 JSON 输入（即，解析错误）时既不抛出异常，也不创建诊断信息。
模板参数
InputType
兼容的输入，例如：
- 一个 std::istream 对象
- 一个 FILE 指针（不能为 null）
- 一个 C 风格的字符数组
- 一个指向单字节字符的空终止字符串的指针
- 一个 std::string
- 一个对象 obj，对于该对象，begin(obj) 和 end(obj) 产生一对有效的迭代器。
IteratorType
兼容的迭代器类型，例如：
- 一对 std::string::iterator 或 std::vector<uint8_t>::iterator
- 一对指针，如 ptr 和 ptr + len
参数
- i (in): 要解析的输入。
- ignore_comments (in): 是否应忽略注释并将其视为空格（true）或产生解析错误（false）；（可选，默认为 false）
- first (in): 字符范围的开始迭代器
- last (in): 字符范围的结束迭代器
返回值
输入是否为有效的 JSON。
异常安全性
强保证：如果抛出异常，JSON 值不会有任何改变。
复杂性
输入长度线性。解析器是一个预测性的 LL(1) 解析器。
注释
(1) UTF-8 字节顺序标记会被静默忽略。
运行时断言：通过运行时断言来执行传递的 FILE 指针不能为 null 的前提条件。
示例
#include <iostream>
#include <iomanip>
#include <nlohmann/json.hpp>
using json = nlohmann::json;
int main()
{
// a valid JSON text
auto valid_text = R"(
{
"numbers": [1, 2, 3]
}
)";
// an invalid JSON text
auto invalid_text = R"(
{
"strings": ["extra", "comma", ]
}
)";
std::cout << std::boolalpha
<< json::accept(valid_text) << ' '
<< json::accept(invalid_text) << '\n';
}
另请参阅
- parse - 从兼容的输入反序列化
- operator>> - 从流反序列化
版本历史
- 在版本 3.0.0 中添加。
- 通过 ignore_comments 忽略注释在版本 3.9.0 中添加。
弃用
重载 (2) 替换了将一对迭代器作为其第一个参数的 accept 调用，该调用在版本 3.8.0 中已被弃用。这个重载将在版本 4.0.0 中被移除。请将所有像 accept({ptr, ptr+len}, …); 的调用替换为accept(ptr, ptr+len, …);
