table

非推奨を表示

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

このライブラリは、テーブル/配列操作の genérica 機能を提供し、全ての機能をグローバル table 変数内に提供します。ライブラリ内のほとんどの機能は、テーブルが配列またはリストを表示することを仮定します。これらの機能の "長さ" は、テーブルの "長さオペレータ" によって結果されます。

概要

関数

  • clear(table : table):()

    指定されたテーブル内のすべてのキーを nulo に設定します。

  • 提供されたテーブルのショートコピーを返します。

  • concat(t : Array,sep : string,i : number,j : number):string

    与えられたテーブル要素の指定された範囲を、指定されたセパレーターで各要素が区分された文字列として返します。

  • create(count : number,value : Variant):table

    指定された値の多くのインスタンスで満たされた新しい テーブルを返します。

  • find(haystack : table,needle : Variant,init : number):Variant

    haystack の開始時点から haystack のインデックスを返します。

  • 指定したテーブルを読み取り専用にします。

  • insert(t : Array,pos : number,value : Variant):()

    配列のターゲットポジションに指定された値を挿入します。

  • insert(t : Array,value : Variant):()

    配列の終わりに提供された値を追加します。

  • 以下の表が凍結されている場合、true を返し、false を返しません。

  • 指定したテーブルの最大数字キーを返します。また、テーブルに数字キーがない場合は、0を返します。

  • move(src : table,a : number,b : number,t : number,dst : table):table

    1つのテーブルから指定された要素の範囲を別のテーブルにコピーします。

  • pack(values... : Variant):Variant

    指定した値を含む新しい テーブルを返します。

  • remove(t : Array,pos : number):Variant

    配列から指定された要素を削除し、余分な要素を後ろにシフトして空のスペースに満たします。

  • sort(t : Array,comp : function):()

    提供される比較関数または < オペレーターを使用して、テーブルの要素をソートします。

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

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

関数

clear

()

指定されたテーブル内のすべてのキーの値を nulo に設定します。これにより、# オペレーターは、0 の返却を可能にします。テーブルの配列の割り当てられた容量が維持されるため、スペースを効率的に再使用できます。


local grades = {95, 82, 71, 92, 100, 60}
print(grades[4], #grades) --> 92、6
table.clear(grades)
print(grades[4], #grades) --> nil、0
-- 評定が再び同じ数のエントリで満たされている場合、
-- 配列のサイズ変更は潜在的に高価ではありませ発生
-- because the capacity was maintained by table.clear.

この関数は、提供されたテーブルを削除/破壊しません。この関数は、再使用するテーブルのために特に使用される必要があります。

パラメータ

table: table

キーがクリアされるテーブル。

戻り値

()

clone

提供されたテーブルの深くないコピーを返します。

パラメータ

クローンするテーブル。

戻り値

提供されたテーブルのクローン。

concat

配列に入力がすべて文字列または数字である場合、 t[i]... sep... t[i+1]... sep... t[j]... t[j] を返します。デフォルトの値は、 i です。デフォルトの値は、 j です。如果 i は 1> j

パラメータ

変換されるテーブル。

sep: string

テーブルの各行の間に結合するストリング。

テーブルのコンテーションの開始インデックス。

既定値: 1

テーブルのコンチェーンの終わりのインデックス。

戻り値

create

配列の部分を含む、number の要素に割り当てられたオプションのあるテーブルを作成します。value が入力されている場合、number のオプションがオプションで満たされます。


local t = table.create(3, "Roblox")
print(table.concat(t)) --> RobloxRobloxRoblox

大きなアレイのようなテーブルに挿入し、要素の数に制限を設定している場合は、この関数を使用してテーブルを初期化することをお勧めします。これにより、メモリのアレイ部分のサイズが十分に大きくなります。これは、小さな量の場合通常は気づくことがありません。

パラメータ

count: number
value: Variant

戻り値

find

Variant

以下の配列のようなテーブル haystack 内で、最初の値の発生を needle 、インデックスから開始します init または提供されていない場合の開始から。如果値が見つからない場合、 1> nil1> が返されます。

直線検索 アルゴリズムが実行されます。


local t = {"a", "b", "c", "d", "e"}
print(table.find(t, "d")) --> 4
print(table.find(t, "z")) --> nil 、因果 z はテーブルに含まれていない
print(table.find(t, "b", 3)) --> nil, because b appears before index 3

パラメータ

haystack: table
needle: Variant
init: number

戻り値

Variant

freeze

この関数は、指定されたテーブルを「無効化」して、その現在の状態で「無効化」します。冷凍されたテーブルを変更すると、エラーが発生します。

このフリーズ効果は浅いため、冷凍テーブル内のテーブルに書き込むことができます。冷凍テーブルを深くフリーズするには、すべての下降テーブルでこの関数を再帰的に呼び出します。

パラメータ

凍結するテーブル。

戻り値

冷凍テーブル。

insert

()

配列のターゲットポジションに指定された値を挿入します。

パラメータ

追加されるテーブル。

pos: number

値が挿入される位置。

value: Variant

テーブルに追加される値。

戻り値

()

insert

()

配列の終わりに提供された値を追加します。

パラメータ

追加されるテーブル。

value: Variant

テーブルに追加される値。

戻り値

()

isfrozen

この関数は、true で、指定されたテーブルが凍結している場合、false 凍結されていない場合、table.freeze() を返します。2>Library.table.freeze()2> を使用して、テーブルを凍結できます。

パラメータ

チェックするテーブル。

戻り値

テーブルが table.freeze() から凍結されているかどうか。

maxn

指定したテーブルの最大数字のキーを返します。テーブルに数字のキーがない場合は、0を返します。テーブルの空白は無視されます。

パラメータ

戻り値

move

コピー元は table src から 5> 源[a] まで、8> 源[b] に到達するまで、表に 1> dz1> 開始して、4> t4> まで。 Japanese:コピー元は table 源 か

デフォルトは dst です。src はソースレンジと重複する可能性があります。

便利性のために dst を返します。

パラメータ

src: table

ソーステーブル。

開始コピーは src[a] です。

以下を含むコピー: src[b] .

コピー into dst[t], ... .

dst: table

目的地テーブル。

既定値: src

戻り値

dst 、便利に。

pack

Variant

すべての引数が "1" 、 "2" などのキーに保存されており、 "n" フィールドが含まれている新しい テーブルを返します。これにより、結果のテーブルは順序ではありません。


local t = table.pack(1, 2, 3)
print(table.concat(t, ", ")) --> 1, 2, 3

パラメータ

values...: Variant

戻り値

Variant

remove

Variant

ポジションポスには、配列から削除された要素の要素を取り除き、削除された要素の値を返します。ポジションが 1 および #t の間の整数の場合、要素を t[pos+1], t[pos+2], ..., t[#t]

パラメータ

要素を削除するテーブル。

pos: number

削除される要素のインデックス。

戻り値

Variant

sort

()

要素の配列の要素を、t[1] からt[#t] まで、comp の順序でソートします。1>comp1> が与えられている場合、4>t[2]4> が最初の要素を受信し、7>t[5]7> が最後の要素を返す関数でなければなりません。

エラー invalid order function for sorting は、comp(a, b)comp(b, a) の両方が 1> true1> を返す場合に発生します。

comp が与えられない場合は、標準の Lua オペレーター < が使用されます。

パラメータ

comp: function

テーブル内の要素を比較するときに使用できるオプションの比較関数。この関数は 2つの要素を受信し、最初の要素が最後の順序でソートされる場合、真に返す必要があります。

既定値: nil

戻り値

()

unpack

指定されたリストからエレメントを返します。デフォルトでは、i は 1 です、jlist の長さです。

この機能は、Global.LuaGlobals.unpack() グローバル関数によっても提供されます。

パラメータ

list: table

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

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

既定値: 1

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

既定値: #list

戻り値