Home › HSP Version › Reference - hspjson.dll › json_get_str

OHDL

json_get_str

JSON 文字列値の取得

json_get_str hid, "path", var, buf_size

hid      : ハンドル
"path"   : JSONPath 風のパス (例 "name", "user.email", "tags[2]")
var      : 結果を格納する文字列変数 (sdim 済)
buf_size : var に sdim で確保したバッファサイズ

(プラグイン / モジュール : hspjson.dll)

解説

指定パスの文字列値を取り出して p3 の変数に書き込みます。
変数は事前に sdim で十分なサイズ確保しておき、その sdim サイズを
p4 (buf_size) に指定してください。

パス形式:
  "name"        → トップレベルのキー
  "user.email"  → ネストしたキー (ドット区切り)
  "tags[2]"     → 配列の 3 番目の要素
  "users[0].name" → 配列要素のフィールド

存在しないパスや型違いの場合は空文字列。

関連項目

json_get_intJSON 整数値の取得(hspjson.dll)
json_get_dblJSON double 値の取得(hspjson.dll)
json_count配列/オブジェクト要素数の取得(hspjson.dll)

情報

プラグイン / モジュールhspjson.dll
バージョン1.0
作成日2026-04-13
著作者IronHSP / hspjson
URLhttps://github.com/inovia/IronHSP
備考hspjson.dll は HSP3 から JSON テキストを読み書きするための小さな
プラグインです。サードパーティ依存ゼロ (自前 parser/writer) で、
~300 KB の単独 DLL として配布できます。

HSP からは package/win32/common/iron_json.hsp を include して使う
のが推奨です (iron_json は出力 var の sdim を自動化したラッパ)。
本ヘルプは生 API の説明です。

JSON ノードは内部でハンドル管理されます。json_parse でツリーを
作成 → 各種 getter で値を取り出し → json_free で解放、という
流れになります。
タイプ拡張命令
グループhspjson ― 値取得
対応環境
  • その他 : Win32 / Win64
hs ファイルhsphelp\hspjson.hs