89 lines
3.7 KiB
C++
89 lines
3.7 KiB
C++
// json.h
|
|
#pragma once
|
|
|
|
#include "cJSON.h"
|
|
#include <cmath>
|
|
#include <cstdio>
|
|
#include <cstring>
|
|
|
|
// The `nspanel_ha_blueprint` namespace encapsulates utility functions for JSON manipulation
|
|
// tailored for the NSPanel Home Assistant Blueprint project.
|
|
namespace nspanel_ha_blueprint {
|
|
|
|
/**
|
|
* Compares the string value of a cJSON object with a target C-string.
|
|
*
|
|
* This function checks if the given cJSON object is not NULL, is a string type,
|
|
* and its value matches the target string provided.
|
|
*
|
|
* @param json_item The cJSON object whose string value is to be compared.
|
|
* @param target_str The target C-string to compare against the cJSON object's value.
|
|
* @return True if the cJSON object's string value matches the target string, false otherwise.
|
|
*/
|
|
bool json_cmp_string(const cJSON* json_item, const char* target_str) {
|
|
if (json_item != NULL && cJSON_IsString(json_item) && json_item->valuestring != NULL) {
|
|
return strcmp(json_item->valuestring, target_str) == 0;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Compares the integer value of a cJSON object with a target unsigned integer.
|
|
*
|
|
* This function checks if the given cJSON object is not NULL, represents a number,
|
|
* and its integer value matches the target unsigned integer provided. It's particularly
|
|
* useful for JSON fields that are expected to contain numeric boolean values (e.g., 0 or 1)
|
|
* or other unsigned integer values.
|
|
*
|
|
* @param json_item The cJSON object whose integer value is to be compared.
|
|
* @param target_uint The target unsigned integer to compare against the cJSON object's value.
|
|
* @return True if the cJSON object's integer value matches the target unsigned integer, false otherwise.
|
|
*/
|
|
bool json_cmp_uint(const cJSON* json_item, unsigned int target_uint) {
|
|
if (json_item != NULL && cJSON_IsNumber(json_item)) {
|
|
return (unsigned int)json_item->valueint == target_uint;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a floating-point value from a cJSON object.
|
|
*
|
|
* @param json_item The cJSON object from which to retrieve the value.
|
|
* @return The floating-point value of the cJSON object if it is a number, NaN otherwise.
|
|
*/
|
|
float json_get_float(const cJSON* json_item) {
|
|
if (json_item != NULL && cJSON_IsNumber(json_item)) {
|
|
return static_cast<float>(json_item->valuedouble);
|
|
}
|
|
return std::nan(""); // Return NaN if not a valid number
|
|
}
|
|
|
|
/**
|
|
* Converts a JSON integer percentage value to a string representing a floating-point number between 0.00 and 1.00.
|
|
*
|
|
* @param json_item The cJSON object containing the integer percentage value.
|
|
* @return A string representation of the floating-point number, or an empty string if the input is invalid.
|
|
*/
|
|
std::string json_percentage_to_float_string(const cJSON* json_item) {
|
|
// Ensure the item is a valid number
|
|
if (json_item != NULL && cJSON_IsNumber(json_item)) {
|
|
// Convert the integer percentage to a float between 0.00 and 1.00
|
|
float percentage = static_cast<float>(json_item->valueint) / 100.0f;
|
|
|
|
// Buffer to hold the formatted string, large enough for "0.00" plus null terminator
|
|
char buffer[8];
|
|
|
|
// Format the floating-point number with two decimal places
|
|
snprintf(buffer, sizeof(buffer), "%.2f", percentage);
|
|
|
|
// Return the formatted string
|
|
return std::string(buffer);
|
|
}
|
|
|
|
// Return an empty string to indicate invalid input or non-numeric JSON item
|
|
return "";
|
|
}
|
|
|
|
} // namespace nspanel_ha_blueprint
|