GS2-Script のユーティリティメソッド
GS2-Script で実行する Lua スクリプト内で利用可能なユーティリティメソッドの説明
GS2-Scriptの拡張スクリプト(Lua言語)で使用可能な拡張メソッドです。
util.table_to_json
Luaのテーブル型(配列)を、JSON形式の文字列に変換します。
Request
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | string | 変換結果のJSON文字列 |
Sample
Code
result = util.table_to_json({a="a", b=1, c=false})
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
json_str = result["result"]
Output
{"a":"a","b":1,"c":false}
util.json_to_table
JSON形式の文字列を、Luaのテーブル型(配列)に変換します。
Request
引数名 | 型 | 説明 |
---|
jsonText | string | JSON形式の文字列 |
disableNumberStringToNumber | bool | JSON内に文字列型で数値が格納されていた時に数値型に変換しない(default: false) |
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | table | 変換結果のLuaテーブル |
Sample
Code
result = util.json_to_table("{\"a\": \"a\", \"b\": 1, \"c\": false}")
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
json_table = result["result"]
util.split
文字列を分割します。
Request
引数名 | 型 | 説明 |
---|
value | string | 元の文字列 |
sep | string | デリミタ、区切り文字列 |
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | table | 分割した文字列のLuaテーブル |
Sample
Code
result = util.split("a,b,c", ",")
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
split_table = result["result"]
print(split_table[1])
print(split_table[2])
print(split_table[3])
Output
http.get
HTTPのGETリクエストを発行します。
Request
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | string | HTTPレスポンスのボディ |
Sample
Code
result = http.get("https://example.com")
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
get_result = result["result"]
http.post
HTTPのPOSTリクエストを発行します。
Request
引数名 | 型 | 説明 |
---|
url | string | 接続先のURL |
contentType | string | HTTPヘッダーのContent-Type |
body | string | HTTPリクエストメッセージのボディ |
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | string | HTTPレスポンスのボディ |
Sample
Code
result = http.get("https://example.com")
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
get_result = result["result"]
util.random
0 〜 1 の浮動小数点数の乱数を生成する
Request
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | float | 生成した乱数 |
Sample
Code
result = util.random()
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
random_value = result["result"]
util.uuid
UUIDv4 に基づく文字列を生成する
Request
Result
メンバ名 | 型 | 説明 |
---|
isError | bool | エラーの有無 |
statusCode | int | ステータスコード |
errorMessage | string | エラーメッセージ |
result | float | 生成したUUID |
Sample
Code
result = util.uuid()
if result.isError then
fail(result['statusCode'], result['errorMessage'])
end
random_value = result["result"]