모듈:JSON/설명문서 문서 원본 보기

JSON 데이터를 읽어들여 값을 반환하거나, 데이터를 수정합니다.<!-- 이 모듈을 사용해 데이터를 수정한 뒤, {{틀|}}을 함께 사용하시면 좋습니다. -->

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

배열의 경우 [[위키백과:Lua|Lua]]를 사용하므로 순서는 1부터 시작하니 유의해 주세요.

=== JSON 코드 ===
JSON 코드는 다음과 같은 다양한 상황에서 입력이 가능합니다. 아래와 같은 내용을 두번째 변수(JSON 코드)에 입력해 주세요.
* JSON 코드 직접 입력
* JSON 문서 불러오기
:JSON 문서를 불러와서 입력하시려면 다음과 같이 틀의 형태로 입력해 주세요.
<pre>{{사용자:홍길동/데이터.json}}
{{:한게임/DB}}</pre>
* 빈 JSON 코드
:비어있는 JSON 코드를 사용하시려면 그냥 두번째 변수를 비워두시면 됩니다.

=== 변수값 얻기 ===
JSON 데이터에 있는 변수의 값을 얻으려면 다음과 같이 입력합니다:
<pre>{{#invoke:JSON|get|(JSON 코드)|(변수)|(기본값)}}</pre>
위와 같이 입력하시면 해당 변수의 값만 그대로 나오며, 값이 없는 경우 기본값이 나옵니다.

예를 들어, <code>var</code> 변수의 값을 얻는다면 이렇게 입력하세요:
<pre>{{#invoke:JSON|get|(JSON 코드)|var}}</pre>

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

=== 변수값 변경 ===
{{#vardefine:value|{{#rand:0|9}}}}
JSON 데이터에 있는 변수의 값을 변경하려면 다음과 같이 입력합니다:
<pre>{{#invoke:JSON|set|(JSON 코드)|(변수)|(값)}}</pre>
위와 같이 입력하시면 해당 변수의 값이 변경된 JSON 코드가 반환됩니다.

예를 들어, <code>var</code> 변수의 값을 <code>{{#var:value}}</code>로 변경할 경우 이렇게 입력하세요:
 <nowiki>{{#invoke:JSON|set|(JSON 코드)|var|</nowiki>{{#var:value}}<nowiki>}}</nowiki>

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

* 변수 제거
:JSON 데이터에 있는 변수를 제거하려면 다음과 같이 변수값을 변경할 때의 값을 입력하지 않으면 됩니다.
:<pre>{{#invoke:JSON|set|(JSON 코드)|(변수)}}</pre>
:위와 같이 입력하시면 입력한 JSON 코드에서 해당 변수가 제거된 값이 나옵니다.
:
:예를 들어, <code>var</code> 변수를 제거하려면 이렇게 입력하세요:
:<pre>{{#invoke:JSON|set|(JSON 코드)|var}}</pre>

=== 작업 조합 ===
만약 여러 작업을 동시에 하고 싶다면 두번째 변수에 이 틀을 다시 넣을 수 있습니다. 이런식으로 말이지요:
 <nowiki>{{#invoke:JSON|get|
{{#invoke:JSON|set|
{{#invoke:JSON|set|
{{#invoke:JSON|set|
{"var":</nowiki><choose><option>true</option><option>false</option></choose><nowiki>}
|var}}
|var1|</nowiki>{{#rand:0|9}}<nowiki>}}
|var2|
{{#invoke:JSON|set||1|ㅁㄴㅇㄹ}}
}}
|var</nowiki>{{#rand:1|2}}<nowiki>}}</nowiki>

== [[도보시오]] ==
* [[틀:JSON]]