/* * Copyright 2004 The WebRTC Project Authors. All rights reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #ifndef RTC_BASE_STRINGS_JSON_H_ #define RTC_BASE_STRINGS_JSON_H_ #include #include #include "absl/strings/string_view.h" #include "json/json.h" // IWYU pragma: export namespace webrtc { /////////////////////////////////////////////////////////////////////////////// // JSON Helpers /////////////////////////////////////////////////////////////////////////////// // Robust conversion operators, better than the ones in JsonCpp. bool GetIntFromJson(const Json::Value& in, int* out); bool GetUIntFromJson(const Json::Value& in, unsigned int* out); bool GetStringFromJson(const Json::Value& in, std::string* out); bool GetBoolFromJson(const Json::Value& in, bool* out); bool GetDoubleFromJson(const Json::Value& in, double* out); // Pull values out of a JSON array. bool GetValueFromJsonArray(const Json::Value& in, size_t n, Json::Value* out); bool GetIntFromJsonArray(const Json::Value& in, size_t n, int* out); bool GetUIntFromJsonArray(const Json::Value& in, size_t n, unsigned int* out); bool GetStringFromJsonArray(const Json::Value& in, size_t n, std::string* out); bool GetBoolFromJsonArray(const Json::Value& in, size_t n, bool* out); bool GetDoubleFromJsonArray(const Json::Value& in, size_t n, double* out); // Convert json arrays to std::vector bool JsonArrayToValueVector(const Json::Value& in, std::vector* out); bool JsonArrayToIntVector(const Json::Value& in, std::vector* out); bool JsonArrayToUIntVector(const Json::Value& in, std::vector* out); bool JsonArrayToStringVector(const Json::Value& in, std::vector* out); bool JsonArrayToBoolVector(const Json::Value& in, std::vector* out); bool JsonArrayToDoubleVector(const Json::Value& in, std::vector* out); // Convert std::vector to json array Json::Value ValueVectorToJsonArray(const std::vector& in); Json::Value IntVectorToJsonArray(const std::vector& in); Json::Value UIntVectorToJsonArray(const std::vector& in); Json::Value StringVectorToJsonArray(const std::vector& in); Json::Value BoolVectorToJsonArray(const std::vector& in); Json::Value DoubleVectorToJsonArray(const std::vector& in); // Pull values out of a JSON object. bool GetValueFromJsonObject(const Json::Value& in, absl::string_view k, Json::Value* out); bool GetIntFromJsonObject(const Json::Value& in, absl::string_view k, int* out); bool GetUIntFromJsonObject(const Json::Value& in, absl::string_view k, unsigned int* out); bool GetStringFromJsonObject(const Json::Value& in, absl::string_view k, std::string* out); bool GetBoolFromJsonObject(const Json::Value& in, absl::string_view k, bool* out); bool GetDoubleFromJsonObject(const Json::Value& in, absl::string_view k, double* out); // Writes out a Json value as a string. std::string JsonValueToString(const Json::Value& json); } // namespace webrtc // Re-export symbols from the webrtc namespace for backwards compatibility. // TODO(bugs.webrtc.org/4222596): Remove once all references are updated. namespace rtc { using ::webrtc::BoolVectorToJsonArray; using ::webrtc::DoubleVectorToJsonArray; using ::webrtc::GetBoolFromJson; using ::webrtc::GetBoolFromJsonArray; using ::webrtc::GetBoolFromJsonObject; using ::webrtc::GetDoubleFromJson; using ::webrtc::GetDoubleFromJsonArray; using ::webrtc::GetDoubleFromJsonObject; using ::webrtc::GetIntFromJson; using ::webrtc::GetIntFromJsonArray; using ::webrtc::GetIntFromJsonObject; using ::webrtc::GetStringFromJson; using ::webrtc::GetStringFromJsonArray; using ::webrtc::GetStringFromJsonObject; using ::webrtc::GetUIntFromJson; using ::webrtc::GetUIntFromJsonArray; using ::webrtc::GetUIntFromJsonObject; using ::webrtc::GetValueFromJsonArray; using ::webrtc::GetValueFromJsonObject; using ::webrtc::IntVectorToJsonArray; using ::webrtc::JsonArrayToBoolVector; using ::webrtc::JsonArrayToDoubleVector; using ::webrtc::JsonArrayToIntVector; using ::webrtc::JsonArrayToStringVector; using ::webrtc::JsonArrayToUIntVector; using ::webrtc::JsonArrayToValueVector; using ::webrtc::JsonValueToString; using ::webrtc::StringVectorToJsonArray; using ::webrtc::UIntVectorToJsonArray; using ::webrtc::ValueVectorToJsonArray; } // namespace rtc #endif // RTC_BASE_STRINGS_JSON_H_