table

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

이 라이브러리는 전역 Library.table``Library.table 라이브러리의 대부분의 함수는 테이블이 배열이나 목록을 나타내는 것으로 가정합니다.이러한 함수에서 테이블의 "길이"는 길이 연산자의 결과를 의미합니다.

요약

함수

  • clear(table : table):()

    지정된 테이블의 모든 키를 nil로 설정합니다.

  • 제공된 테이블의 얕은 복사본을 반환합니다.

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

    지정된 범위의 테이블 요소를 각 요소가 지정된 분리 기호로 구분되는 문자열로 반환합니다.

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

    지정된 값의 많은 인스턴스로 채워진 새 테이블을 반환합니다.

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

    반환 첫 번째 발생의 needle 내에서 시작하는 haystack 의 인덱스를 반환합니다. starting from init .

  • 지정된 테이블을 읽기 전용으로 만듭니다.

  • 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

    한 테이블에서 지정된 범위의 요소를 다른 테이블로 복사합니다.

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

    제공된 값을 포함하는 새 테이블을 반환합니다.

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

    지정된 요소를 배열에서 제거하여 나중에 빈 공간을 채우기 위해 요소를 아래로 이동합니다.

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

    제공된 비교 함수나 < 연산자를 사용하여 테이블 요소를 정렬합니다.

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

    지정된 목록의 모든 요소를 튜플로 반환합니다.

함수

clear

()

지정된 테이블 내의 모든 키 값을 nil로 설정합니다.이로 인해 # 연산자가 지정된 테이블에 대해 0 를 반환합니다.테이블 배열 부분의 할당된 용량이 유지되어 공간을 효율적으로 재사용할 수 있습니다.


local grades = {95, 82, 71, 92, 100, 60}
print(grades[4], #grades) --> 92, 6
table.clear(grades)
print(grades[4], #grades) --> 무효, 0
-- 등급이 동일한 입력 수로 다시 채워지면,
-- 잠재적으로 비용이 많이 드는 배열 크기 조정은 발생하지 않음
-- because the capacity was maintained by table.clear.

이 함수는 제공된 테이블을 삭제하거나 파괴하지 않습니다. 이 함수는 재사용할 테이블에 특별히 사용되도록 설계되었습니다.

매개 변수

table: table

키가 지워질 테이블.

반환

()

clone

제공된 테이블의 얼지 않은 얕은 복사본을 반환합니다.

매개 변수

복제할 테이블.

반환

제공된 테이블의 복제본.

concat

모든 요소가 문자열이나 숫자인 배열을 제공하면 t[i] ... sep ... t[i+1] ... sep ... t[j] 문자열을 반환합니다.sep의 기본값은 빈 문자열이고, i의 기본값은 1이고, j의 기본값은 #t입니다.i가 보다 크면 빈 문자열을 반환합니다.

매개 변수

문자열로 변환될 테이블.

sep: string

테이블의 각 항목 사이에 결합될 문자열.

테이블 조합의 시작 인덱스.

기본값: 1

테이블 조합의 마지막 인덱스.

반환

create

지정된 number 요소에 할당된 배열 부분으로 구성된 테이블을 생성하며, 선택적으로 지정된 value 로 채워집니다.


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

큰 배열형 테이블에 삽입하고 요소 수의 합리적인 상한을 확신하는 경우 이 함수를 사용하여 테이블을 초기화하는 것이 좋습니다.이렇게 하면 테이블의 배열 부분의 메모리가 충분히 크기가 조정될 수 있으므로 크기 조정이 비용이 많이 들 수 있습니다.소량의 경우 일반적으로 알아차리기 어렵습니다.

매개 변수

count: number
value: Variant

반환

find

Variant

지정된 배열 테이블 haystack 내에서 값 needle 의 첫 번째 발생을 찾으십시오, 인덱스 init 또는 시작 부분이 제공되지 않은 경우.값이 찾을 수 없으면 nil 가 반환됩니다.

A 선형 검색 알고리즘이 수행됩니다.


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().

매개 변수

확인할 테이블.

반환

테이블이 table.freeze() 동결되었는지 여부.

maxn

제공된 테이블의 최대 숫자 키를 반환하거나 테이블에 숫자 키가 없으면 0을 반환합니다. 테이블의 간격은 무시됩니다.

매개 변수

반환

move

인덱스 부터 시작하여 테이블 에서 요소를 복사하여 테이블 까지 테이블 로 이동합니다.할당 문과 동일합니다 dst[t], ..., dst[t + (b - a)] = src[a], ..., src[b] .

기본값은 입니다. 대상 범위와 원본 범위가 겹칠 수 있습니다.

편의를 위해 dst를 반환합니다.

매개 변수

src: table

원본 테이블.

복사 시작 위치는 src[a]입니다.

최대 src[b]

다음으로 복사 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

배열에서 pos 위치의 요소를 제거하고 제거된 요소의 값을 반환합니다.pos가 1#t 사이의 정수일 때, 요소 t[pos+1], t[pos+2], ..., t[#t] 와 요소 t[#t] 가 이동하고 요소가 지워집니다.pos 매개 변수가 제공되지 않으면 pos는 마지막 요소를 제거하는 테이블의 길이로 기본값을 설정합니다.

매개 변수

요소가 제거된 테이블.

pos: number

제거되는 요소의 인덱스.

반환

Variant

sort

()

배열 t의 요소를 특정 순서로 정렬하여 t[1]에서 t[#t]까지 합니다.comp 가 주어지면 첫 번째 요소가 마지막 순서에서 두 번째 요소 앞에 올 때 true를 반환하는 함수여야 합니다.

오류 invalid order function for sorting 는 둘 다 comp(a, b)comp(b, a) 반환하는 경우 발생합니다.The error is thrown if both and return true .

comp 가 지정되지 않으면 표준 Luau 연산자 < 가 대신 사용됩니다.

매개 변수

comp: function

테이블의 요소를 비교할 때 사용할 선택적 비교 함수.이 함수는 두 요소를 받고, 첫 번째 요소가 마지막 순서에서 두 번째보다 먼저 정렬되어야 하는 경우 true를 반환해야 합니다.

기본값: nil

반환

()

unpack

지정된 목록에서 요소를 반환합니다. 기본적으로 i 는 1이고 jlist 의 길이입니다.

이와 동일한 기능은 전역 unpack() 함수에서도 제공됩니다.

매개 변수

list: table

열릴 요소 목록.

해체할 첫 번째 요소의 인덱스.

기본값: 1

해체할 마지막 요소의 인덱스.

기본값: #list

반환