API JsonKind ko - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
JsonKind
ClassicUO โข Runtime API
๊ฐ์ JSON ํธํ ์ข ๋ฅ๋ฅผ ํ์ธํฉ๋๋ค.
์ ํํ ๊ตฌ๋ฌธ
JsonKind(value:Any) -> String
๋งค๊ฐ๋ณ์
valueโ ์ซ์, String, ๋ฐฐ์ด, List, Dictionary, JsonBoolean ๋๋ JsonNull. Dictionary ํค๋ String์ด์ด์ผ ํฉ๋๋ค. ์ฐธ์กฐ ๊ณต์ ๋ ํ์ฉํ์ง๋ง ์ํ ์ฐธ์กฐ๋ ์ค๋ฅ์ ๋๋ค.
๋ฐํ๊ฐ
String:number, string, array, object, boolean, null ๋๋ unsupported. ๊ฐ์ฅ ๋ฐ๊นฅ ์ข ๋ฅ๋ง ํ์ธํฉ๋๋ค.
๋์
- UO. ์๋ ๋ก์ปฌ Basic ํจ์์ด๋ฉฐ ๊ฒ์ ํจํท์ ๋ณด๋ด์ง ์์ต๋๋ค. JsonParse/JsonStringify๋ ๋ฉ๋ชจ๋ฆฌ์์ ์๋ํฉ๋๋ค. Basic True๋ ์ซ์1๋ก ์ ์ฅ๋๋ฏ๋ก JSON true์๋ JsonBoolean(True)๋ฅผ ์ฌ์ฉํฉ๋๋ค. JsonNull()์ null๊ณผ0์ ๊ตฌ๋ถํฉ๋๋ค.
- ์ ํํ ์ซ์๋ง ํ์ฉํฉ๋๋ค. ์ ์ ๊ฐ์ด ยฑ9007199254740991 ๋ฒ์๋ฅผ ๋์ผ๋ฉด ์ค๋ฅ์ด๋ฉฐ ํฐ ID๋ String์ผ๋ก ์ ์ฅํฉ๋๋ค. ๋ค๋ฅธ ์ซ์๋ Double ์ ๋ฐ๋์ ๋๋ค. ์๊ฒฉํ UTF-8์ ์ฌ์ฉํ๋ฉฐ ์ ๋ ฅ BOM์ ํ์ฉํ๊ณ ์ถ๋ ฅ์๋ ์์ต๋๋ค. ์๋ชป๋ Unicode๋ ์ค๋ฅ์ ๋๋ค.
- ์ ํ:1048576 UTF-16 ์ฝ๋ ๋จ์,4MiB,64๋จ๊ณ ์ปจํ ์ด๋,100000 ๊ฐ ๋ ธ๋. ์ด๊ณผํ๋ฉด ์ค๋ฅ์ ๋๋ค. ๋ถ์/์ฝ๊ธฐ๋ ์ ์ปฌ๋ ์ ์ ๋ง๋ค๋ฉฐ ์ ์ฅ์ ๋ฉ๋ชจ๋ฆฌ ๊ฐ์ฒด๋ฅผ ๋ณต์ ํ์ง ์์ต๋๋ค.
- Save๋ ์ ์ฒด ๋ฐ์ดํฐ๋ฅผ ๊ฒ์ฆํ๊ณ ๋ถ๋ชจ ํด๋๋ฅผ ๋ง๋ ๋ค ๋์ ์์ ๊ณ ์ ์์ ํ์ผ์ ์ฐ๊ณ ๋ฒํผ๋ฅผ ๋น์ด ํ ์ด๋/๊ต์ฒดํฉ๋๋ค. ๊ต์ฒด ์ ์คํจ/์ทจ์๋ ๊ธฐ์กด ํ์ผ์ ๋ณด์กดํฉ๋๋ค. OS๊ฐ ํ์ฉํ๋ฉด ์์ ํ์ผ์ ์ ๋ฆฌํฉ๋๋ค. ์๋ฃ๋ ๊ต์ฒด๋ ์ทจ์ํ์ง ์์ต๋๋ค.
- 256๊ฐ ๊ฐ๋ง๋ค,4096๋ฐ์ดํธ/๋ฌธ์ ๋ธ๋ก ์ฌ์ด ๋ฐ ๊ต์ฒด ์ ์ ์ผ์์ ์ง/์ค์ง๋ฅผ ํ์ธํฉ๋๋ค. ์ถ๊ฐ ์ค๋ ๋๋ฅผ ๋ง๋ค์ง ์์ผ๋ฉฐ ๊ฐ๋ณ OS ํธ์ถ์ ๊ฐ์ ์ค๋จํ ์ ์์ต๋๋ค. ๋์ ์ ์ฅ์ ๋ง์ง๋ง ์ฑ๊ณต ๊ต์ฒด๊ฐ ๋จ์ผ๋ฉฐ DB ํธ๋์ญ์ ์ด ์๋๋๋ค.
๋ด๋ถ ํจ์: ํธ์ถ๋ถํฐ ๊ฒฐ๊ณผ๊น์ง
๊ฐ์ JSON ํธํ ์ข ๋ฅ๋ฅผ ํ์ธํฉ๋๋ค.
1. Kind
์ซ์, String, ๋ฐฐ์ด, List, Dictionary, JsonBoolean ๋๋ JsonNull. Dictionary ํค๋ String์ด์ด์ผ ํฉ๋๋ค. ์ฐธ์กฐ ๊ณต์ ๋ ํ์ฉํ์ง๋ง ์ํ ์ฐธ์กฐ๋ ์ค๋ฅ์ ๋๋ค.
String:number, string, array, object, boolean, null ๋๋ unsupported. ๊ฐ์ฅ ๋ฐ๊นฅ ์ข ๋ฅ๋ง ํ์ธํฉ๋๋ค.
ํ๋ก์ ํธ ์์ค: external/InjectionScript/src/InjectionScript/Runtime/BasicJson.cs; ํจ์ Kind.
Config.Load(fileName, defaults)๋ ์ Dictionary๋ฅผ ๋ฐํํฉ๋๋ค. ์ ์ฅ๋ ์ต์์ ํค๊ฐ defaults์ ๊น์ ๋ณต์ฌ๋ณธ์ ๋ฎ์ด์ฐ๊ณ ์ค์ฒฉ ๊ฐ์ฒด๋ ํต์งธ๋ก ๊ต์ฒดํฉ๋๋ค. Config.Save(fileName, settings)๋ ๋ช ์์ ์ผ๋ก ์ ์ฅํ๋ฉฐ ๋ฐํ๊ฐ์ด ์์ต๋๋ค. Config.GetFlag(settings, key, fallback=False)๋1/True ๋๋0/False๋ฅผ ๋ฐํํ๋ฉฐ ๊ธฐ์กด ๊ฐ์ด ๋ถ๋ฆฌ์ธ์ด ์๋๋ฉด ์ค๋ฅ์ ๋๋ค. Config.SetFlag(settings, key, value)๋ ๋ฉ๋ชจ๋ฆฌ๋ง ๋ณ๊ฒฝํ๊ณ ๋ฐํ๊ฐ์ด ์์ต๋๋ค. Load/Save๋ String ํค Dictionary๊ฐ ํ์ํฉ๋๋ค. ๋ด๋ถ Private RequireObject๋ ๋ฐ๊นฅ ์ข ๋ฅ๋ฅผ ํ์ธํ๊ณ JSON ๋ณํ์ ์ ์ฒด ๋ด์ฉ์ ๊ฒ์ฆํฉ๋๋ค.
์์
JsonKind ยท 1
# JsonKind ยท 1
#
# ๊ฐ์ JSON ํธํ ์ข
๋ฅ๋ฅผ ํ์ธํฉ๋๋ค.
#
# String:number, string, array, object, boolean, null ๋๋ unsupported. ๊ฐ์ฅ ๋ฐ๊นฅ ์ข
๋ฅ๋ง ํ์ธํฉ๋๋ค.
Option Explicit On
Sub Main()
# Main์ ์คํํฉ๋๋ค. value=12 โ "number"; value="12" โ "string".
Return JsonKind(12) & ':' & JsonKind('12')
End Sub
๋งค๊ฐ๋ณ์ ๋ฐ ์คํ ์ค๋ช :
- Main์ ์คํํฉ๋๋ค. value=12 โ "number"; value="12" โ "string".
JsonKind ยท 2
# JsonKind ยท 2
#
# ๊ฐ์ JSON ํธํ ์ข
๋ฅ๋ฅผ ํ์ธํฉ๋๋ค.
#
# String:number, string, array, object, boolean, null ๋๋ unsupported. ๊ฐ์ฅ ๋ฐ๊นฅ ์ข
๋ฅ๋ง ํ์ธํฉ๋๋ค.
Option Explicit On
Sub Main()
# Main์ ์คํํฉ๋๋ค. value=JsonParse("[1]") โ "array"; value=Dictionary() โ "object".
Return JsonKind(JsonParse('[1]')) & ':' & JsonKind(Dictionary())
End Sub
๋งค๊ฐ๋ณ์ ๋ฐ ์คํ ์ค๋ช :
- Main์ ์คํํฉ๋๋ค. value=JsonParse("[1]") โ "array"; value=Dictionary() โ "object".
JsonKind ยท 3
# JsonKind ยท 3
#
# ๊ฐ์ JSON ํธํ ์ข
๋ฅ๋ฅผ ํ์ธํฉ๋๋ค.
#
# String:number, string, array, object, boolean, null ๋๋ unsupported. ๊ฐ์ฅ ๋ฐ๊นฅ ์ข
๋ฅ๋ง ํ์ธํฉ๋๋ค.
Option Explicit On
Sub Main()
# Main์ ์คํํฉ๋๋ค. value=JsonBoolean(False) โ "boolean"; value=JsonNull() โ "null".
Return JsonKind(JsonBoolean(False)) & ':' & JsonKind(JsonNull())
End Sub
๋งค๊ฐ๋ณ์ ๋ฐ ์คํ ์ค๋ช :
- Main์ ์คํํฉ๋๋ค. value=JsonBoolean(False) โ "boolean"; value=JsonNull() โ "null".