모듈:JSON/설명문서

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

사용법

변수

[]로 묶이는 배열을 사용하고 싶으시다면 변수를 숫자로 지정해 주세요. 숫자로 된 변수는 배열의 순서로 인식됩니다. {}로 묶이는 객체를 사용하려면 숫자로만 이루어진 변수명만 아니면 됩니다. 단, 중간에 건너뛰는 등 배열의 순서가 잘못되거나 같은 단계에서 숫자 이외의 변수명이 있을 경우 숫자로만 이루어져 있어도 객체로 간주됩니다.

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