GS2-Script のユーティリティメソッド

GS2-Script で実行する Lua スクリプト内で利用可能なユーティリティメソッドの説明

util.table_to_json

Luaのテーブル型（配列）を、JSON形式の文字列に変換します。

Request

引数名	型	説明
table	table	Luaテーブル

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

a
b
c

http.get

HTTPのGETリクエストを発行します。

Request

引数名	型	説明
url	string	接続先のURL

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