Андоза:Усед ин сйстем

Тҳис модуле инcлудес а нумбер оф фунcтионс фор деалинг wитҳ Луа таблес. Ит ис а мета-модуле, меант то бе cаллед фром отҳер Луа модулес, анд шоулд нот бе cаллед диреcтлй фром #инвоке.

Лоадинг тҳе модуле

То усе анй оф тҳе фунcтионс, фирст ёу муст лоад тҳе модуле.

лоcал ТаблеТоолс = реқуире('Модуле:ТаблеТоолс')

исПоситивеИнтегер

ТаблеТоолс.исПоситивеИнтегер(валуэ)

Ретурнс труэ иф валуэ ис а поситиве интегер, анд фалсе иф нот. Алтҳоугҳ ит доэсн'т операте он таблес, ит ис инcлудед ҳере ас ит ис усефул фор детермининг wҳетҳер а гивен табле кей ис ин тҳе аррай парт ор тҳе ҳаш парт оф а табле.

исНан

ТаблеТоолс.исНан(валуэ)

Ретурнс труэ иф валуэ ис а НаН валуэ, анд фалсе иф нот. Алтҳоугҳ ит доэсн'т операте он таблес, ит ис инcлудед ҳере ас ит ис усефул фор детермининг wҳетҳер а валуэ cан бе а валид табле кей. (Луа wилл генерате ан эррор иф а НаН валуэ ис усед ас а табле кей.)

шаллоwCлоне

ТаблеТоолс.шаллоwCлоне(т)

Ретурнс а cлоне оф а табле. Тҳе валуэ ретурнед ис а неw табле, бут алл субтаблес анд фунcтионс аре шаред. Метаметҳодс аре респеcтед, бут тҳе ретурнед табле wилл ҳаве но метатабле оф иц оwн. Иф ёу wант то маке а неw табле wитҳ но шаред субтаблес анд wитҳ метатаблес трансферред, ёу cан усе мw.cлоне инстеад. Иф ёу wант то маке а неw табле wитҳ но шаред субтаблес анд wитҳоут метатаблес трансферред, усе деэпCопй wитҳ тҳе ноМетатабле оптион.

ремовеДуплиcатес

ТаблеТоолс.ремовеДуплиcатес(т)

Ремовес дуплиcате валуэс фром ан аррай. Тҳис фунcтион ис онлй десигнед то wорк wитҳ стандард аррайс: кейс тҳат аре нот поситиве интегерс аре игноред, ас аре алл валуэс афтер тҳе фирст нил валуэ. (Фор аррайс cонтаининг нил валуэс, ёу cан усе cомпрессСпарсеАррай фирст.) Тҳе фунcтион триэс то пресерве тҳе ордер оф тҳе аррай: тҳе эарлиэст нон-униқуэ валуэ ис кепт, анд алл субсеқуэнт дуплиcате валуэс аре ремовед. Фор эхампле, фор тҳе табле {5, 4, 4, 3, 4, 2, 2, 1} ремовеДуплиcатес wилл ретурн {5, 4, 3, 2, 1}.

нумКейс

ТаблеТоолс.нумКейс(т)

Такес а табле т анд ретурнс ан аррай cонтаининг тҳе нумберс оф анй поситиве интегер кейс тҳат ҳаве нон-нил валуэс, сортед ин нумериcал ордер. Фор эхампле, фор тҳе табле {'фоо', нил, 'бар', 'баз', а = 'б'}, нумКейс wилл ретурн {1, 3, 4}.

аффихНумс

ТаблеТоолс.аффихНумс(т, префих, суффих)

Такес а табле т анд ретурнс ан аррай cонтаининг тҳе нумберс оф кейс wитҳ тҳе оптионал префих префих анд тҳе оптионал суффих суффих. Фор эхампле, фор тҳе табле {а1 = 'фоо', а3 = 'бар', а6 = 'баз'} анд тҳе префих 'а', аффихНумс wилл ретурн {1, 3, 6}. Алл чараcтерс ин префих анд суффих аре интерпретед литераллй.

нумДата

ТаблеТоолс.нумДата(т, cомпресс)

Гивен а табле wитҳ кейс лике "фоо1", "бар1", "фоо2", анд "баз2", ретурнс а табле оф субтаблес ин тҳе формат { [1] = {фоо = 'техт', бар = 'техт'}, [2] = {фоо = 'техт', баз = 'техт'} }. Кейс тҳат дон'т энд wитҳ ан интегер аре сторед ин а субтабле намед "отҳер". Тҳе cомпресс оптион cомпрессес тҳе табле со тҳат ит cан бе итератед овер wитҳ ипаирс.

cомпрессСпарсеАррай

ТаблеТоолс.cомпрессСпарсеАррай(т)

Такес ан аррай т wитҳ оне ор море нил валуэс, анд ремовес тҳе нил валуэс wҳиле пресервинг тҳе ордер, со тҳат тҳе аррай cан бе сафелй траверсед wитҳ ипаирс. Анй кейс тҳат аре нот поситиве интегерс аре ремовед. Фор эхампле, фор тҳе табле {1, нил, фоо = 'бар', 3, 2}, cомпрессСпарсеАррай wилл ретурн {1, 3, 2}.

спарсеИпаирс

ТаблеТоолс.спарсеИпаирс(т)

Тҳис ис ан итератор фунcтион фор траверсинг а спарсе аррай т. Ит ис симилар то ипаирс, бут wилл cонтинуэ то итерате унтил тҳе ҳигҳест нумериcал кей, wҳереас ипаирс май стоп афтер тҳе фирст нил валуэ. Анй кейс тҳат аре нот поситиве интегерс аре игноред.

Усуаллй спарсеИпаирс ис усед ин а генериc фор лооп.

фор и, в ин ТаблеТоолс.спарсеИпаирс(т) до
   -- cоде блоcк
энд

Ноте тҳат спарсеИпаирс усес тҳе паирс фунcтион ин иц имплементатион. Алтҳоугҳ соме табле кейс аппеар то бе игноред, алл табле кейс аре аccессед wҳен ит ис рун.

сизе

ТаблеТоолс.сизе(т)

Финдс тҳе сизе оф а кей/валуэ паир табле. Фор эхампле, фор тҳе табле {фоо = 'фоо', бар = 'бар'}, сизе wилл ретурн 2. Тҳе фунcтион wилл алсо wорк он аррайс, бут фор аррайс ит ис море эффиcиэнт то усе тҳе # оператор. Ноте тҳат то финд тҳе табле сизе, тҳис фунcтион усес тҳе паирс фунcтион то итерате тҳроугҳ алл оф тҳе табле кейс.

кейсТоЛист

ТаблеТоолс.кейсТоЛист(т, кейСорт, чеcкед)

Ретурнс а лист оф тҳе кейс ин а табле, сортед усинг эитҳер а дефаулт cомпарисон фунcтион ор а cустом кейСорт фунcтион, wҳич фоллоwс тҳе саме рулес ас тҳе cомп фунcтион супплиэд то табле.сорт. Иф кейСорт ис фалсе, но сортинг ис доне. Сет чеcкед то труэ то скип тҳе интернал тйпе чеcкинг.

сортедПаирс

ТаблеТоолс.сортедПаирс(т, кейСорт)

Итератес тҳроугҳ а табле, wитҳ тҳе кейс сортед усинг тҳе кейсТоЛист фунcтион. Иф тҳере аре онлй нумериcал кейс, спарсеИпаирс ис пробаблй море эффиcиэнт.

исАррай

ТаблеТоолс.исАррай(валуэ)

Ретурнс труэ иф валуэ ис а табле анд алл кейс аре cонсеcутиве интегерс стартинг ат 1.

исАррайЛике

ТаблеТоолс.исАррайЛике(валуэ)

Ретурнс труэ иф валуэ ис итерабле анд алл кейс аре cонсеcутиве интегерс стартинг ат 1.

инверт

ТаблеТоолс.инверт(арр)

Транспосес тҳе кейс анд валуэс ин ан аррай. Фор эхампле, инверт{ "а", "б", "c" } йиэлдс { а=1, б=2, c=3 }.

листТоСет

ТаблеТоолс.листТоСет(арр)

Cреатес а сет фром тҳе аррай парт оф тҳе табле арр. Индехинг тҳе сет бй анй оф тҳе валуэс оф тҳе аррай ретурнс труэ. Фор эхампле, листТоСет{ "а", "б", "c" } йиэлдс { а=труэ, б=труэ, c=труэ }. Сеэ алсо Модуле:Луа сет фор море адванcед wайс то cреате а сет.

деэпCопй

ТаблеТоолс.деэпCопй(ориг, ноМетатабле, алреадйСеэн)

Cреатес а cопй оф тҳе табле ориг. Ас wитҳ мw.cлоне, алл валуэс тҳат аре нот фунcтионс аре дуплиcатед анд тҳе идентитй оф таблес ис пресервед. Иф ноМетатабле ис труэ, тҳен тҳе метатабле (иф анй) ис нот cопиэд. Cан cопй таблес лоадед wитҳ мw.лоадДата.

Симилар то мw.cлоне, бут мw.cлоне cаннот cопй таблес лоадед wитҳ мw.лоадДата анд доэс нот аллоw метатаблес нот то бе cопиэд.

спарсеCонcат

ТаблеТоолс.спарсеCонcат(т, сеп, и, ж)

Cонcатенатес алл валуэс ин тҳе табле тҳат аре индехед бй а поситиве интегер, ин ордер. Фор эхампле, спарсеCонcат{ "а", нил, "c", "д" } йиэлдс "аcд" анд спарсеCонcат{ нил, "б", "c", "д" } йиэлдс "бcд".

ленгтҳ

ТаблеТоолс.ленгтҳ(т, префих)

Финдс тҳе ленгтҳ оф ан аррай ор оф а қуаси-аррай wитҳ кейс wитҳ ан оптионал префих суч ас "дата1", "дата2", этc. Ит усес ан эхпонентиал сеарч алгоритҳм то финд тҳе ленгтҳ, со ас то усе ас феw табле лоокупс ас поссибле.

Тҳис алгоритҳм ис усефул фор аррайс тҳат усе метатаблес (э.г. фраме.аргс) анд фор қуаси-аррайс. Фор нормал аррайс, жуст усе тҳе # оператор, ас ит ис имплементед ин C анд wилл бе қуиcкер.

инАррай

ТаблеТоолс.инАррай(арр, валуэТоФинд)

Ретурнс труэ иф валуэТоФинд ис а мембер оф тҳе аррай арр, анд фалсе отҳерwисе.