Lua Globals

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

次に、Lua のネイティブな関数と変数のリストがあります。これらの関数は、Lua 5.1.4の標準インストールで使用できますが、Roblox での一部の機能の作動方法にはいくつかの違いがあります。

概要

関数

  • assert(value : Variant,errorMessage : string):Variant

    提供された valuefalse または nil に解決すると、エラーが発生します。

  • error(message : string,level : number):void

    スレッドの実行を停止し、エラーをスローします。

  • キロバイト単位のメモリーヘップサイズを返します。

  • getmetatable(t : Variant):Variant

    指定したテーブルのメタテーブルを返します。

  • ループで使用するテーブルとイテレーター関数を返します。

  • loadstring(contents : string,chunkname : string):Variant

    提供されたコードを実行可能な関数として返します。

  • newproxy(addMetatable : bool):userdata

    オプションでメタテーブルを持つことができる空の userdata を作成します。

  • next(t : table,lastKey : Variant):Variant,Variant

    ループで使用するイテレーター関数。

  • for ループで使用するイテレーター関数と提供されたテーブルを返します。

  • pcall(func : function,args : Tuple):bool,Variant

    提供された関数を実行し、エラーをキャッチし、関数の成功とその結果を返します。

  • print(params : Tuple):void

    提供されたすべての値を出力に印刷します。

  • rawequal(v1 : Variant,v2 : Variant):bool

    メタメソッドをパスすることなく、v1v2 と等しいかどうかを返します。

  • rawget(t : table,index : Variant):Variant

    メタメソッドをすべて無視して、table[index] の実際の値を取得します。

  • メタメソッドを無視して、ストリングまたはテーブルの長さを返します。

  • rawset(t : table,index : Variant,value : Variant):table

    メタメソッドをすべてオーバーライドして、table[index] の実際の値を設定します。

  • require(module : ModuleScript):Variant

    ModuleScript が返した値を返し、それがまだ実行されていない場合は実行します。

  • select(index : Variant,args : Tuple):Tuple

    与えられたインデックスの後にすべての引数を返します。

  • setmetatable(t : table,newMeta : Variant):table

    指定されたテーブルのメタテーブルを設定します。

  • tonumber(arg : Variant,base : number):Variant

    不可能な場合は、提供された値を数値または n に変換します。

  • tostring(e : Variant):string

    不可能な場合は、提供された値を文字列または n に変換します。

  • type(v : Variant):string

    提供されたオブジェクトの基本タイプを返します。

  • unpack(list : table,i : number,j : number):Variant

    渡されたリストのすべての要素を、ツプリットとして返します。

  • xpcall(f : function,err : function,args : Tuple):bool,Variant

    似ています pcall() を除き、カスタムエラーハンドラーを使用します。

プロパティ

  • 同じコンテキストレベルのすべてのスクリプトの共有テーブル。

  • 現在のインタープリターバージョンを含むストリングを含むグローバル変数。

関数

assert

Variant

value が false または nil である場合、Throw an error if the provided value is false または nil です。assertion が通過すると、Throw an error if the provided false がすべての値を返します。


local product = 90 * 4
assert(product == 360, "Oh dear, multiplication is broken")
-- The line above does nothing, because 90 times 4 is 360

パラメータ

value: Variant

アルグメントとして与えられる値。

errorMessage: string

主張が失敗した場合にエラーに表示されるテキスト。

既定値: assertion failed!

戻り値

Variant

error

void

最後に保護された関数を呼び出し、message をエラーメッセージとして出力します。エラーを含む関数が保護された関数で呼び出されていない場合は、pcall() などの保護された関数でエラーメッセージが呼び出されま契約解除。エラー機能自体は戻りません。エラー機能はスクリプトエラーとして動作し

The level 引数は、エラーの位置を指定します。レベル 1 (デフォルト) では、エラーの位置はエラー関数が呼び出された場所です。レベル 2 は、エラー関数が呼び出された場所にエラーポジションメッセージ報を追加します; そして、その後、レベル 0

パラメータ

message: string

表示するエラーメッセージ。

level: number

印刷する情報のレベル。デフォルトは 1 です。

既定値: 1

戻り値

void

gcinfo

メモリのヘッドサイズをキロバイト単位で返します。この数値は、ガビジョンコレクターがオブジェクトを解放すると、オペレーションシステムのメモリ使用率を反映します。

戻り値

getmetatable

Variant

以下のテーブルのメタテーブルを返します t 、1つがある場合、そうでない場合は nil を返します。如果 t にメタテーブルがあり、__metatable メタメソッドが設設定するされている場合、その値を代わりに返します。


-- デモンストを取得する:
local meta = {}
local t = setmetatable({}, meta)
print(getmetatable(t) == meta) --> 真
-- メタテーブルメタメソッドを設定して、元のメタテーブルを取り戻すことができなくする:
meta.__metatable = "protected"
print(getmetatable(t)) --> protected

パラメータ

t: Variant

メタテーブルを取得するオブジェクト。

戻り値

Variant

ipairs

次の 3つの値を返します:iterator 関数、t テーブル、および 0 数。イテレーター関数が呼び出されるたびに、テーブル内の次の数値のインデックスペアを返します。一般的な for-ループで使用すると、t の次の数値のインデックスペアをイテレートできます:


local fruits = {"apples", "oranges", "kiwi"}
for index, fruit in ipairs(fruits) do
print(index, fruit) --> 1 アップル、2 オレンジ、3 キウイ、などなど…
end

パラメータ

要素を反復するテーブル。

loadstring

Variant

配列から Lua コードを読み込み、関数として返します。

RobloRoblox(ロブロックス) の Lua は、loadstring() を使用して、標準の Lua 5.1 以上ではバイナリバージョンの Lua をロードできません。

loadstring() はデフォルトで無効になっています。有効化のガイドについては、ServerScriptService を参照してください。

警告: このメソッドは、返された関数に Luau の特定の最適化を無効にします。ユーザーがエクスペリエンスでコードを実行することを許可するために、loadstring() を使用する場合、

パラメータ

contents: string

Lua コードとして読み込む指定された文字列。

chunkname: string

エラーメッセージとデバッグ情報のオプションチャンク名。未指定の場合は、Lua は contents 文字列を使用します。

戻り値

Variant

newproxy

オプションでメタテーブルを持つことができる空の userdata を作成します。

パラメータ

addMetatable: bool
既定値: false

戻り値

for ループの使用中に、テーブルのすべてのキー/値ペアを通過するように、nilfor のイテレーター関数を返します:


local scores = {
["John"] = 5,
["Sally"] = 10
}
for name, score in pairs(scores) do
print(name .. " has score: " .. score)
end

パラメータ

イテレートする配列またはディクションテーブル。

戻り値

pcall

pcall() 関数を保護モードで呼び出し、指定された引コードを持つ func にエラーが発生しないようにします。これは、pcall() がエラメッセージを

パラメータ

func: function

保護モードで呼び出される関数。

args: Tuple

実行中に func に送信する引数。

戻り値

Variant

print

void

任意の数の引数を受信し、その値を出力に印刷します。 print は形式の出力には使用されませんが、デバッRoblox(ロブロックス)用にのみ使用されます。形式の出力には string.format() を使用します

パラメータ

params: Tuple

出力する数値の引数。

戻り値

void

rawequal

メタメソッドを呼び出さずに、v1v2 と同等であるかどうかをチェックします。

パラメータ

v1: Variant

比較する最初の変数。

v2: Variant

比較する 2 番目の変数。

戻り値

rawget

Variant

メタメソッドを呼び出すことなく table[index] の実際の値を取得します。

パラメータ

参照するテーブル。

index: Variant

t からインデックスを取得する。

戻り値

Variant

rawlen

メタメソッドを呼び出すことなく、ストリングまたはテーブルの長さを返します。

パラメータ

参照するテーブル。

戻り値

rawset

メタメソッドを呼び出さずに、table[index] の実際の値を value に設定します。

パラメータ

参照するテーブル。

index: Variant

t を指定した value に設定するインデックス。 必須、ゼロから異なる必要があります。

value: Variant

テーブル t の指定された値に設定する値。

戻り値

require

Variant

提供された ModuleScript を実行し、 ModuleScript の呼び出し (通常はテーブルまたは関数) を返します。Global.LuaGlobals.re必須uire の呼び出しを実行すると、2>Class.ModuleScript2> 内のすべての値が共有され、5>Global.LuaGlobals.re必須u必須re5> の呼び出しにアクセスできます。

上記の「オブジェクト共有」動作は、クライアン

また、ModuleScript ユーザーが実行したい、Roblox (MainModule インスタンスの名前を含む) にアップロードされた場合、require() 機能を使用してアセット ID の2>Class.ModuleScript2>にのみ、サーバーで読み込むこと

パラメータ

module: ModuleScript

Class.ModuleScript が実行され、Class.ModuleScript が提供する値を取り戻す。

戻り値

Variant

Class.ModuleScript が返したもの (通常はテーブルまたは関数です)。

select

引数番号 index の後にすべての引数を返します。引数がネガティブな場合、引数リストの終わりから返ります。


print(select(2, "A", "B", "C")) --> B C
print(select(-1, "A", "B", "C")) --> C

index 引数が "#" に設定されている場合、返された後に渡された引数の数。


print(select("#", "A", "B", "C")) --> 3

パラメータ

index: Variant

引数のインデックスは、args の後にすべての引数を返すインデックスに設定されます。"#" が設定されている場合、その後に返された引数の数。

args: Tuple

引数のツープ。

戻り値

setmetatable

指定したテーブルのメタテーブルを t に設設定するします。newMeta が nul の場合、 newMeta のメタテーブルは削除されます。最後に、


local meta = {__metatable = "protected"}
local t = {}
setmetatable(t, meta) -- これは t のメタテーブルを設定します
-- 我々は今、メタテーブル付きの table、t を持っています。如果我々がそれを変更しようとしたら...
setmetatable(t, {}) --> Error: cannot change a protected metatable

パラメータ

メタテーブルを設定するテーブル。

newMeta: Variant

なしの場合、指定された テーブルのメタテーブルは削除されます。そうでない場合、指定されたテーブルのメタテーブルは t に設定されます。

戻り値

tonumber

Variant

引数を指定されたベースに変換して値を解読しようとします。変換できない場合は、この関数は nil を返します。

ベースは 2 から 36 の間の整数であることが多く、含まれます。ベースは 10 の上で、文字 'A' (上方または下方の両方の場合) は 10 を表し、文字 'B' は 11 を表し、その他、 'Z' が 35 を表します。デフォルトのベースでは、ディジタルの部分と

0x で始まり、ベースが提供されていない場合、0x はトリミングされ、ベースは 16 または hexadecimal であると仮定されます。


print(tonumber("1337")) --> 1337 (ベース 10、デシマル)
print(tonumber("1.25")) --> 1.25 (ベース 10 はデシマルパーツがある場合があります)
print(tonumber("3e2")) --> 300 (ベース 10 は有効な数値の 10 倍、3 × 10 ^ 2)
print(tonumber("25", 8)) --> 21 (ベース 8、オクタル)
print(tonumber("0x100")) --> 256 (ベース 16、十六進制)
print(tonumber("roblox")) --> nil (エラーを起動させません)
-- ヒント: 不変換可能な数をエラーで上げたい場合は、assert を使用してください
print(assert(tonumber("roblox"))) --> Error: assertion failed

パラメータ

arg: Variant

変換するオブジェクト。

base: number

arg を変換する数値ベース。

既定値: 10

戻り値

Variant

tostring

任意のタイプの引数を受信し、合理的な形式のストリングに変換します。数文字列の変換についての完全なコントロールには、string.formatを使用します。 e のメタテーブルに __tostring のメタメソッドがある場合、e として唯一の引数として返され、結果が返さ


local isRobloxCool = true
-- Boolean を文字列に変換してから、Concatenate:
print("Roblox is cool: " .. tostring(isRobloxCool)) --> Roblox is cool: true

パラメータ

e: Variant

変換するオブジェクト。

戻り値

type

単一の引数のタイプを弦文字列として返します。この関数の可能な結果は "nil" (単語ではなく、値ではない)、 "number"、 "string"、 "button"、 "userdata" などです。

パラメータ

v: Variant

タイプを返すオブジェクト。

戻り値

unpack

Variant

指定されたテーブルからエレメントを返します。デフォルトでは、i は 1 で、jlist の長さです。長さオペレータによって定義されています。

パラメータ

list: table

アンパックするエレメントのリスト。

パックを解凍する最初の要素のインデックス。

既定値: 1

最後の要素をアンパックするインデックス。

既定値: #list

戻り値

Variant

xpcall

この関数は pcall() と似ていますが、新しいエラーハンドラーを設定できます。

xpcall() は、保��

パラメータ

保護モードで呼び出される関数。

エラーが発生したときに xpcall がエラー処理を行う機能。

args: Tuple

戻り値

Variant

プロパティ

同じコンテキストレベルのすべてのスクリプトの共有テーブル。

_VERSION

現在のインタープリターバージョンを含むストリングを持つグローバル変数 (機能ではありません)。