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".

en ยท ru ยท uk ยท fr ยท de ยท it ยท es ยท zh-tw ยท ja ยท ko

Basic