Skip to content

Latest commit

 

History

History
159 lines (104 loc) · 4.88 KB

README.md

File metadata and controls

159 lines (104 loc) · 4.88 KB
Raw

MojoJson v1.2.3

MojoJson is an extremely simple and super fast JSON parser. The parser supports all standard Json formats and provides simple APIs for visit different types of the Json values. Also the core algorithm can be easily implemented by various programming languages.

The current implementations as follow:

  • For C#.

    The core parsing code only 400 lines, and the implementation only use the core .NET lib, and just has one file that can be easily integrated into any C# project.

  • For C.

    The core parsing code only 300 lines, and the implementation only use the C standard lib, and just has one C file that can be easily integrated into any C project.

    Note: the only different from C# is that the C code does not support SetEscapeString API to convert escaped strings, so the escaped strings will remain original state in C JsonValue.

License

MojoJson is licensed under the MIT License.

How to use

  • For C#

    • Parse Json string.
    var jsonValue = MojoJson.Json.Parse(string jsonString);
    • Whether to convert escaped strings when ParseString.
    /// default false
MojoJson.Json.SetEscapeString(bool isEscapeString)
    • JsonValue is primitive type.
    public string AsString();
public float  AsFloat();
public int    AsInt();
public bool   AsBool();
public bool   IsNull();
    • JsonValue is JsonObject
    /// Get the JsonObject, that is a set of k-v pairs, and each value is JsonValue.
public Dictionary<string, JsonValue> AsObject();

/// Get the JsonValue from JsonObject by key.
public JsonValue AsObjectGet(string key);

/// Get the JsonObject from JsonObject by key.
public Dictionary<string, JsonValue> AsObjectGetObject(string key);

/// Get the JsonArray from JsonObject by key.
public List<JsonValue> AsObjectGetArray(string key);

/// Get the string from JsonObject by key.
public string AsObjectGetString(string key);

/// Get the float from JsonObject by key.
public float AsObjectGetFloat(string key);

/// Get the int from JsonObject by key.
public int AsObjectGetInt(string key);

/// Get the bool from JsonObject by key.
public bool AsObjectGetBool(string key);

/// Get the null from JsonObject by key.  
public bool AsObjectGetIsNull(string key);
    • JsonValue is JsonArray.
    /// Get the JsonArray, that is JsonValue list.
public List<JsonValue> AsArray();

/// Get the JsonValue from JsonArray at index.
public JsonValue AsArrayGet(int index);

/// Get the JsonObject from JsonArray at index.
public Dictionary<string, JsonValue> AsArrayGetObject(int index);

/// Get the JsonArray from JsonArray at index.
public List<JsonValue> AsArrayGetArray(int index);

/// Get the string from JsonArray at index. 
public string AsArrayGetString(int index);

/// Get the float from JsonArray at index.
public float AsArrayGetFloat(int index);

/// Get the int from JsonArray at index.
public int AsArrayGetInt(int index);

/// Get the bool from JsonArray at index.
public bool AsArrayGetBool(int index);

/// Get the null from JsonArray at index.
public bool AsArrayGetIsNull(int index);

  • For C

    • Parse Json string.
    JsonValue* value = AJson->Parse(jsonString);
    • Free any JsonValue memory.
    AJson->Destroy(JsonValue* jsonValue);
    • JsonValue is JsonObject.
    bool        (*GetBool)  (JsonObject* object, const char* key, bool  defaultValue);
int         (*GetInt)   (JsonObject* object, const char* key, int   defaultValue);
float       (*GetFloat) (JsonObject* object, const char* key, float defaultValue);

char*       (*GetString)(JsonObject* object, const char* key, const char* defaultValue);
JsonObject* (*GetObject)(JsonObject* object, const char* key);
JsonArray*  (*GetArray) (JsonObject* object, const char* key);
    • JsonValue is JsonArray.
    bool        (*GetBool)  (JsonArray* array, int index);
int         (*GetInt)   (JsonArray* array, int index);
float       (*GetFloat) (JsonArray* array, int index);

char*       (*GetString)(JsonArray* array, int index);
JsonObject* (*GetObject)(JsonArray* array, int index);
JsonArray*  (*GetArray) (JsonArray* array, int index);

How was born

The original implementation and core algorithm came from the Json.h of the pure C game engine Mojoc.

Support

If the source code is useful or helpful for you, maybe buy me a coffee via Sponsor Button.