C++?JSON庫?nlohmann::basic_json::accept的用法解析

更新時間：2023年06月19日 14:41:54 作者：泡沫o0

nlohmann::basic_json::accept 是 Nlohmann JSON 庫中的一個方法，它用于檢查一個字符串是否可以解析為有效的 JSON，這篇文章主要介紹了C++?JSON庫nlohmann::basic_json::accept的用法,需要的朋友可以參考下

簡介

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 字節(jié)的整型，分別被解釋為 UTF-8、UTF-16 和 UTF-32。

與 parse 函數(shù)不同，此函數(shù)在遇到無效的 JSON 輸入（即，解析錯誤）時既不拋出異常，也不創(chuàng)建診斷信息。

模板參數(shù)

InputType

兼容的輸入，例如：

一個 std::istream 對象
一個 FILE 指針（不能為 null）
一個 C 風格的字符數(shù)組
一個指向單字節(jié)字符的空終止字符串的指針
一個 std::string
一個對象 obj，對于該對象，begin(obj) 和 end(obj) 產生一對有效的迭代器。

IteratorType

兼容的迭代器類型，例如：

一對 std::string::iterator 或 std::vector<uint8_t>::iterator
一對指針，如 ptr 和 ptr + len

參數(shù)

i (in): 要解析的輸入。
ignore_comments (in): 是否應忽略注釋并將其視為空格（true）或產生解析錯誤（false）；（可選，默認為 false）
first (in): 字符范圍的開始迭代器
last (in): 字符范圍的結束迭代器

返回值

輸入是否為有效的 JSON。

異常安全性

強保證：如果拋出異常，JSON 值不會有任何改變。

復雜性

輸入長度線性。解析器是一個預測性的 LL(1) 解析器。

注釋

(1) UTF-8 字節(jié)順序標記會被靜默忽略。

運行時斷言：通過運行時斷言來執(zhí)行傳遞的 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';
}