Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scottcgi/mojojson
A simple and fast JSON parser.
https://github.com/scottcgi/mojojson
csharp-library json json-api json-lib json-libraries json-library json-parser
Last synced: 5 days ago
JSON representation
A simple and fast JSON parser.
- Host: GitHub
- URL: https://github.com/scottcgi/mojojson
- Owner: scottcgi
- License: mit
- Created: 2018-01-13T14:32:51.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-04-17T08:19:28.000Z (almost 4 years ago)
- Last Synced: 2025-01-16T08:12:33.501Z (5 days ago)
- Topics: csharp-library, json, json-api, json-lib, json-libraries, json-library, json-parser
- Language: C
- Homepage:
- Size: 77.1 KB
- Stars: 295
- Watchers: 19
- Forks: 38
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
## 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.
* Released versions in [releases](https://github.com/scottcgi/MojoJson/releases).
* Release changes in [ChangeLog](https://github.com/scottcgi/MojoJson/blob/master/ChangeLog.md).
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](https://github.com/scottcgi/MojoJson/blob/master/LICENSE).
## How to use
* For C#
* Parse Json string.
```csharp
var jsonValue = MojoJson.Json.Parse(string jsonString);
```
* Whether to convert escaped strings when **ParseString**.
```csharp
/// default false
MojoJson.Json.SetEscapeString(bool isEscapeString)
```
* JsonValue is **primitive** type.
```csharp
public string AsString();
public float AsFloat();
public int AsInt();
public bool AsBool();
public bool IsNull();
```
* JsonValue is **JsonObject**
```csharp
/// Get the JsonObject, that is a set of k-v pairs, and each value is JsonValue.
public Dictionary AsObject();
/// Get the JsonValue from JsonObject by key.
public JsonValue AsObjectGet(string key);
/// Get the JsonObject from JsonObject by key.
public Dictionary AsObjectGetObject(string key);
/// Get the JsonArray from JsonObject by key.
public List 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**.
```csharp
/// Get the JsonArray, that is JsonValue list.
public List AsArray();
/// Get the JsonValue from JsonArray at index.
public JsonValue AsArrayGet(int index);
/// Get the JsonObject from JsonArray at index.
public Dictionary AsArrayGetObject(int index);
/// Get the JsonArray from JsonArray at index.
public List 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.
```c
JsonValue* value = AJson->Parse(jsonString);
```
* Free any JsonValue memory.
```c
AJson->Destroy(JsonValue* jsonValue);
```
* JsonValue is **JsonObject**.
```c
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**.
```c
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](https://github.com/scottcgi/Mojoc/blob/master/Engine/Toolkit/Utils/Json.h) of the pure C game engine [Mojoc](https://github.com/scottcgi/Mojoc).
## Support
If the source code is **useful** or **helpful** for you, maybe buy me a coffee via **Sponsor Button**.