TopGit theo dõi zserge/jsmn trên GitHub, đã đạt 4.2k sao. Jsmn is a world fastest JSON parser/tokenizer. This is the official repo replacing the old one at Bitbucket
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
jsmn (pronounced like 'jasmine') is a minimalistic JSON parser in C. It can be
easily integrated into resource-limited or embedded projects.
You can find more information about JSON format at json.org
Library sources are available at https://github.com/zserge/jsmn
The web page with some information about jsmn can be found at
http://zserge.com/jsmn.html
Philosophy
Most JSON parsers offer you a bunch of functions to load JSON data, parse it
and extract any value by its name. jsmn proves that checking the correctness of
every JSON packet or allocating temporary objects to store parsed JSON fields
often is an overkill.
JSON format itself is extremely simple, so why should we complicate it?
jsmn is designed to be robust (it should work fine even with erroneous
data), fast (it should parse data on the fly), portable (no superfluous
dependencies or non-standard C extensions). And of course, simplicity is a
key feature - simple code style, simple algorithm, simple integration into
other projects.
Features
compatible with C89
no dependencies (even libc!)
highly portable (tested on x86/amd64, ARM, AVR)
about 200 lines of code
extremely small code footprint
API contains only 2 functions
no dynamic memory allocation
incremental single-pass parsing
library code is covered with unit-tests
Design
The rudimentary jsmn object is a token. Let's consider a JSON string:
Strings: "name", "Jack", "age" (keys and some values)
Number: 27
In jsmn, tokens do not hold any data, but point to token boundaries in JSON
string instead. In the example above jsmn will create tokens like: Object
[0..31], String [3..7], String [12..16], String [20..23], Number [27..29].
Every jsmn token has a type, which indicates the type of corresponding JSON
token. jsmn supports the following token types:
Object - a container of key-value pairs, e.g.:
{ "foo":"bar", "x":0.3 }
Array - a sequence of values, e.g.:
[ 1, 2, 3 ]
String - a quoted sequence of chars, e.g.: "foo"
Primitive - a number, a boolean (true, false) or null
Besides start/end positions, jsmn tokens for complex types (like arrays
or objects) also contain a number of child items, so you can easily follow
object hierarchy.
This approach provides enough information for parsing any JSON data and makes
it possible to use zero-copy techniques.
Usage
Download jsmn.h, include it, done.
#include "jsmn.h"
...
jsmn_parser p;
jsmntok_t t[128]; /* We expect no more than 128 JSON tokens */
jsmn_init(&p);
r = jsmn_parse(&p, s, strlen(s), t, 128); // "s" is the char array holding the json content
Since jsmn is a single-header, header-only library, for more complex use cases
you might need to define additional macros. #define JSMN_STATIC hides all
jsmn API symbols by making them static. Also, if you want to include jsmn.h
from multiple C files, to avoid duplication of symbols you may define JSMN_HEADER macro.
/* In every .c file that uses jsmn include only declarations: */
#define JSMN_HEADER
#include "jsmn.h"
/* Additionally, create one jsmn.c file for jsmn implementation: */
#include "jsmn.h"
Note: Unlike JSON data types, primitive tokens are not divided into
numbers, booleans and null, because one can easily tell the type using the
first character:
't', 'f' - boolean
'n' - null
'-', '0'..'9' - number
Token is an object of jsmntok_t type:
typedef struct {
jsmntype_t type; // Token type
int start; // Token start position
int end; // Token end position
int size; // Number of child (nested) tokens
} jsmntok_t;
Note: string tokens point to the first character after
the opening quote and the previous symbol before final quote. This was made
to simplify string extraction from JSON data.
All job is done by jsmn_parser object. You can initialize a new parser using:
jsmn_parser parser;
jsmntok_t tokens[10];
jsmn_init(&parser);
// js - pointer to JSON string
// tokens - an array of tokens available
// 10 - number of tokens available
jsmn_parse(&parser, js, strlen(js), tokens, 10);
This will create a parser, and then it tries to parse up to 10 JSON tokens from
the js string.
A non-negative return value of jsmn_parse is the number of tokens actually
used by the parser.
Passing NULL instead of the tokens array would not store parsing results, but
instead the function will return the number of tokens needed to parse the given
string. This can be useful if you don't know yet how many tokens to allocate.
If something goes wrong, you will get an error. Error will be one of these:
JSMN_ERROR_INVAL - bad token, JSON string is corrupted
JSMN_ERROR_NOMEM - not enough tokens, JSON string is too large
JSMN_ERROR_PART - JSON string is too short, expecting more JSON data
If you get JSMN_ERROR_NOMEM, you can re-allocate more tokens and call
jsmn_parse once more. If you read json data from the stream, you can
periodically call jsmn_parse and check if return value is JSMN_ERROR_PART.
You will get this error until you reach the end of JSON data.
Other info
This software is distributed under MIT license,
so feel free to integrate it in your commercial products.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/zserge/jsmn là nguồn chính thức.
zserge/jsmn có bao nhiêu sao?
zserge/jsmn có 4.2k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/zserge/jsmn. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
zserge/jsmn có những chủ đề gì?
GitHub topics của zserge/jsmn: "json-data", "json-string", "parsing". TopGit xếp repo vào nhóm mã nguồn mở.
zserge/jsmn có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho zserge/jsmn. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
zserge/jsmn còn đang phát triển không?
Commit gần nhất trên zserge/jsmn là 2.4 năm trước (theo timestamp GitHub). Repo có 823 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
zserge/jsmn dùng license gì?
zserge/jsmn phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
zserge/jsmn viết bằng ngôn ngữ gì?
zserge/jsmn chủ yếu viết bằng C. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
Chưa chắc jsmn có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về jsmn.