모듈:JSON/설명문서: 두 판 사이의 차이

2018년 6월 24일 (일) 13:41 판

JSON 데이터를 읽어들여 값을 반환하거나, 데이터를 수정합니다.

사용법

변수

객체를 사용한다면 속성명을 그대로 입력하시면 됩니다.

배열의 경우 Lua를 사용하므로 순서는 1부터 시작한다는 것을 유의해 주세요.

이 모듈은 null을 처리할 수 없으며 없는 값으로 간주됩니다. 따라서 null을 사용하는 데이터에는 이 모듈을 사용하실 수 없습니다.

JSON 코드

JSON 코드는 다음과 같은 다양한 상황에서 입력이 가능합니다. 아래와 같은 내용을 두번째 변수(JSON 코드)에 입력해 주세요.

JSON 코드 직접 입력
JSON 문서 불러오기

JSON 문서를 불러와서 입력하시려면 다음과 같이 틀의 형태로 입력해 주세요.

{{사용자:홍길동/데이터.json}}
{{:한게임/DB}}

빈 JSON 코드

비어있는 JSON 코드를 사용하시려면 {}나 []만 입력해 주세요.

변수값 얻기

JSON 데이터에 있는 변수의 값을 얻으려면 다음과 같이 입력합니다:

{{#invoke:JSON|get|(JSON 코드)|(변수)|(기본값)}}

위와 같이 입력하시면 해당 변수의 값만 그대로 나오며, 값이 없는 경우 기본값이 나옵니다.

예를 들어, var 변수의 값을 얻는다면 이렇게 입력하세요:

{{#invoke:JSON|get|(JSON 코드)|var}}

{{JSON}}을 이용하면 더 간단히 입력하실 수 있습니다. 자세한 내용은 해당 문서를 확인해 주세요.

변수값 변경

JSON 데이터에 있는 변수의 값을 변경하려면 다음과 같이 입력합니다:

{{#invoke:JSON|set|(JSON 코드)|(변수)|(값)}}

위와 같이 입력하시면 해당 변수의 값이 변경된 JSON 코드가 반환됩니다.

예를 들어, var 변수의 값을 {{#rand:0|9}}로 변경할 경우 이렇게 입력하세요:

{{#invoke:JSON|set|(JSON 코드)|var|{{#rand:0|9}}}}

변수 추가

JSON 데이터에 있는 변수를 추가하려면 변수값을 변경할 때와 같이 입력하시면 됩니다.

변수 제거

JSON 데이터에 있는 변수를 제거하려면 다음과 같이 변수값을 변경할 때의 값을 입력하지 않으면 됩니다.

{{#invoke:JSON|set|(JSON 코드)|(변수)}}

위와 같이 입력하시면 입력한 JSON 코드에서 해당 변수가 제거된 값이 나옵니다.

예를 들어, var 변수를 제거하려면 이렇게 입력하세요:

{{#invoke:JSON|set|(JSON 코드)|var}}

작업 조합

만약 여러 작업을 동시에 하고 싶다면 두번째 변수에 이 틀을 다시 넣을 수 있습니다. 이런식으로 말이지요:

{{#invoke:JSON|get|
{{#invoke:JSON|set|
{{#invoke:JSON|set|
{{#invoke:JSON|set|
{"var":true}
|var}}
|var1|{{#rand:0|9}}}}
|var2|
{{#invoke:JSON|set|[]|1|ㅁㄴㅇㄹ}}
}}
|var{{#rand:1|2}}}}

도보시오

틀:JSON

@@ 59번째 줄: / 59번째 줄: @@
 |var1|</nowiki>{{#rand:0|9}}<nowiki>}}
 |var2|
-{{#invoke:JSON|set||1|ㅁㄴㅇㄹ}}
+{{#invoke:JSON|set|[]|1|ㅁㄴㅇㄹ}}
 }}
 |var</nowiki>{{#rand:1|2}}<nowiki>}}</nowiki>