Bə mətni dəvarde

Modul:TableTools/doc

Сy Vikipedija

This is the documentation page for Modul:TableTools

Ym modul mymkunot dojdə de Lua čədvəlon ko karde. Umumi əcəj funksijon bəpe rost de #invoke tələb kardə nybun, u iglə čo modulonədə oko doə bybu.

Oko dojro iminəni moduli pekarde lozime. Šablon:LuaCode

isPositiveInteger

[kodi sərost karde]

Šablon:LuaCode Ogyrdynijedə Šablon:LuaTrue girəm Šablon:Codevar — mysbətə təmomə ədəd u Šablon:LuaFalse čo čurə. Maǧyl ym funksijə dyryst bə čədvəlon aidyš ni, əv lozime bo umute - hacər cy kylidə massivi ja xeš-čədvəlije.

Šablon:LuaCode Ogyrdynijedə Šablon:LuaTrue girəm Šablon:Codevar yštənədə NaN u čo čurə Šablon:LuaFalse. Maǧyl ym funksijə dyryst bə čədvəlon aidyš ni, əv lozime bo umute - bəzne be ym cy čədvəli hacər.

shallowClone

[kodi sərost karde]

Šablon:LuaCode Čədvəli kloni ogyrdynijedə. Ogyrdynijə cij yštənən nujə čədvəle, əmma həmmə žinəčədvəlon u funksijon čo bejdən. Metamodon vyrəbəvyrə bejdən, əmma ogyrdynijə čədvəl metačədvəlon məzmunədə niše. Girəm šymə pidəjone žinəčədvəlon u metačədvəlon kopijə karde, oko bydənən Šablon:Scribunto reference. Girəm šymə pidəjone žinəčədvəlon kopijə karde, əmma metačədvəlon vyrə nyovaxte, oko bydənən Šablon:Code de parametri Šablon:Code.

removeDuplicates

[kodi sərost karde]

Šablon:LuaCode Udalяet iz massiva znaçeniя-dublikatı. Funkцiя prednaznaçena dlя rabotı tolьko so standartnımi massivami: obrabatıvaюtsя tolьko klюçi-polojitelьnıe цelıe çisla, a vse znaçeniя posle pervoqo Šablon:LuaCode iqnoriruюtsя. (Dlя massivov, soderjaщix Šablon:LuaCode, ispolьzuйte Šablon:Code pered эtoй funkцieй.) Funkцiя staraetsя soxranitь porяdok sledovaniя эlementov — ostavlяetsя pervoe vxojdenie znaçeniя, a vse posleduющie udalяюtsя. Naprimer, dlя tabliцı Šablon:LuaCode Šablon:Code vernёt Šablon:LuaCode.

Šablon:LuaCode Prinimaet na vxod tabliцu Šablon:Codevar i vozvraщaet massiv iz polojitelьnıx цelıx çisel, kotorıe яvlяюtsя klюçami tabliцı dlя dannıx s nepustım znaçeniem, otsortirovannıй v porяdke vozrastaniя. Naprimer, dlя tabliцı Šablon:LuaCode vızov Šablon:Code vernёt Šablon:LuaCode.

Šablon:LuaCode Prinimaet na vxod tabliцu Šablon:Codevar i vozvraщaet massiv iz polojitelьnıx цelıx çisel, kotorım sootvetstvuюt klюçi tabliцı s opцionalьnım prefiksom Šablon:Codevar i opцionalьnım suffiksom Šablon:Codevar. Naprimer, dlя tabliцı Šablon:LuaCode i prefiksa Šablon:Codevar vızov Šablon:Code vernёt Šablon:LuaCode. Vse simvolı v Šablon:Codevar i Šablon:Codevar interpretiruюtsя bukvalьno.

Šablon:LuaCode Dla tabliцı s klюçami vida Šablon:Codevar, Šablon:Codevar, Šablon:Codevar i Šablon:Codevar vozvraщaet tabliцı s podtabliцami v formate Šablon:LuaCode. Klюçi, ne zakançivaющiesя çislom razmeщaюtsя v podtabliцe Šablon:Codevar. Opцiя Šablon:Codevar pozvolяet ispolьzovatь tabliцu dlя цikla s pomoщью Šablon:Code.

compressSparseArray

[kodi sərost karde]

Šablon:LuaCode Prinimaet na vxod massiv Šablon:Codevar s pustımi znaçeniяmi (Šablon:LuaCode) i ubiraet ix, soxranяя porяdok, çtobı massiv moq ispolьzovatьsя v Šablon:Code. Neçislovıe klюçi udalяюtsя. Naprimer, dlя tabliцı Šablon:LuaCode vızov Šablon:Code vernёt Šablon:LuaCode.

sparseIpairs

[kodi sərost karde]

Šablon:LuaCode İterator dlя perebora эlementov razrejennoqo massiva Šablon:Codevar. Analoqiçen Šablon:Scribunto reference, no prodoljitsя do dostijeniя klюça s maksimalьnım çislovım znaçeniem, v otliçe ot obıçnoqo Šablon:Code, ostanavlivaющeqosя na pervom Šablon:LuaCode. Neçislovıe klюçi iqnoriruюtsя.

Šablon:Code mojet ispolьzovatьsя dlя цikla Šablon:Code.

Šablon:LuaCode

Obratite vnimanie, çto funkцiя Šablon:Code osnovana na Šablon:Scribunto reference. Xota v iterator dlя цikla moqut peredavatьsя ne vse klюçi, çitatьsя budut vsё ravno vse.

Šablon:LuaCode Vozraщaet razmer tabliцı par klюç-znaçenie. Naprimer, dlя tabliцı Šablon:LuaCode vızov Šablon:Code vernёt Šablon:Code. Funkцiя takje rabotaet i dlя massivov, no dlя nix sleduet ispolьzovatь vstroennıй operator яzıka Šablon:Code. Obratite vnimanie, çto v svoeй rabote funkцiя ispolьzuet funkцiю Šablon:Scribunto reference dlя iterirovaniя po vsem klюçam.

keysToList

[kodi sərost karde]

Šablon:LuaCode Vozvraщaet spisok klюçeй tabliцı, ispolьzuя libo sortirovku po umolçaniю, libo proizvolьnuю funkцiю Šablon:Codevar, sootvestvuющuю pravilam dlя funkцii Šablon:Code dlя Šablon:Scribunto reference.

sortedPairs

[kodi sərost karde]

Šablon:LuaCode İterator, perebiraющiй klюçi tabliцı v porяdke, vozvraщaemom funkцieй Šablon:Code. Esli v tabliцe ispolьzuюtsя tolьko çislovıe klюçi, Šablon:Code budet эffektivnee.

Šablon:LuaCode Vozvraщaet Šablon:LuaTrue, esli vse klюçi tabliцı — polojitelьnıe çisla, naçinaя s Šablon:Code.

Šablon:LuaCode Sozdaёt mnojestvo na osnove znaçeniй çislovıx klюçeй tabliцı Šablon:Codevar. Poluçenie znaçeniя mnojestva dlя znaçeniй Šablon:Codevar vernёt Šablon:LuaTrue. Šablon:LuaCode

Šablon:LuaCode Transponiruet klюçi i znaçeniя massiva. Naprimer, Šablon:Code} vernёt Šablon:Code}. Rabotaet tolьko dlя çislovıx klюçeй.

Šablon:LuaCode Sozdaёt kopiю tabliцı Šablon:Codevar. Kak i pri ispolьzovanii Šablon:Code vse znaçeniя, ne яvlяющiesя funkцiяmi, dubliruюtsя i identiçnostь tabliц soxranяetsя. Esli Šablon:Codevar vıstavlяetsя v Šablon:LuaTrue, metatabliцa (esli imeetsя) ne kopiruetsя. Mojet kopirovatь tabliцı, zaqrujennıe s pomoщью Šablon:Code.

V otliçie ot эtoй funkцii Šablon:Code ne rabotaet s tabliцami, zaqrujennımi s pomoщью Šablon:Code, i ne imeet vozmojnosti ne kopirovatь metatabliцı.

sparseConcat

[kodi sərost karde]

Šablon:LuaCode Proizvodit konkatenaцiю vsex znaçeniй dlя çislovıx klюçeй s soxraneniem ix porяdka.

Šablon:LuaCode Vozvraщaet dlinu massiva ili psevdomassiva s klюçami vida Šablon:Code, Šablon:Code i t.d. İspolьzuet alqoritm эksponenцialьnoqo poiska, poэtomu proizvoditsя minimalьnoe koliçestvo obraщeniй.

Alqoritm polezen dlя massivov s metatabliцami (naprimer, Šablon:Scribunto reference) i dlя psevdomassivov. Dlя obıçnıx massivov predpoçtitelьnee operator Šablon:Scribunto reference, realizovannıй na Si, on budet rabotatь zametno bıstree.

Šablon:LuaCode Vozvraщaet Šablon:LuaTrue esli Šablon:Codevar vxodit v Šablon:Codevar ili Šablon:LuaFalse inaçe.