TapHome

Triedenie

Triediace funkcie skriptu TapHome — ORDER, ORDERINDEX a ich varianty STRICT a zostupné varianty na triedenie hodnôt alebo vracanie indexov poradia.

Existuje viacero variantov ORDER:
Vzostupne – ORDER, ORDERSTRICT – ORDERINDEX, ORDERINDEXSTRICT
Zostupne – ORDERDESC, ORDERDESCSTRICT – ORDERINDEXDESC, ORDERINDEXDESCSTRICT

ORDER

Funkcia ORDER triedi zadané vstupné hodnoty vzostupne a vráti ich v novej kolekcii. Prijíma n hodnôt (až 100 argumentov) alebo jednu kolekciu. Hodnoty nemusia byť numerické, ale musia byť porovnateľné (napr. čísla, TIMESPAN, DATETIME, reťazce). Zmiešané typy (napr. čísla a reťazce) nie sú povolené. Hodnoty NaN a NULL sa ignorujú a nie sú zahrnuté vo výslednej kolekcii.

ORDER( n1, n2, n3 , … )
ORDER( collection )

Príklady:

ORDER(3, 1, 2)				= {1, 2, 3}
ORDER(1)					= {1}
ORDER(3, NaN, 2, NaN)		= {2, 3}
ORDER(NaN)					= {}
ORDER('Z', 'a', 'X')				= {'X', 'Z', 'a'}
ORDER(“str1”, “STR2”, “stR1”} 		= {"STR2", "stR1", "str1"}
ORDER(“str1”, NULL, “STR2”, “stR1”} = {"STR2", "stR1", "str1"}

ORDER(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {TIMESPAN(0,0,0,0,99), TIMESPAN(0,0,0,0,100)}
ORDER(NULL, TIMESPAN(0,0,0,0,99)					= {TIMESPAN(0,0,0,0,99)}

ORDERINDEX

Funkcia ORDERINDEX triedi vstupné hodnoty vzostupne a namiesto hodnôt vráti kolekciu indexov, ktoré udávajú pozície pôvodných hodnôt v zoradenom poradí. Prijíma n hodnôt (až 100 argumentov) alebo jednu kolekciu. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Zmiešané typy nie sú povolené. Hodnoty NaN a NULL sa ignorujú a nie sú zahrnuté vo výslednej kolekcii.

ORDERINDEX( n1, n2, n3 , … )
ORDERINDEX( collection )

Príklady:

ORDERINDEX(3, 1, 2)				= {1, 2, 0}
ORDERINDEX(1)					= {0}
ORDERINDEX(3, NaN, 2, NaN)		= {2, 0}
ORDERINDEX(NaN)					= {}
ORDERINDEX('Z', 'a', 'X')				= {2, 0, 1}
ORDERINDEX(“str1”, “STR2”, “stR1”} 		= {1, 2, 0}
ORDERINDEX(“str1”, NULL, “STR2”, “stR1”} = {2, 3, 0}

ORDERINDEX(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {1, 0}
ORDERINDEX(NULL, TIMESPAN(0,0,0,0,99)					= {1}

ORDERSTRICT

Funkcia ORDERSTRICT triedi vstupné hodnoty vzostupne a vráti ich v novej kolekcii. Prijíma n hodnôt (až 100 argumentov) alebo jednu kolekciu. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Hodnoty NaN a NULL sú zahrnuté a sú vždy zoradené ako prvé.

ORDERSTRICT( n1, n2, n3 , … )
ORDERSTRICT( collection )

Príklady:

ORDERSTRICT(3, 1, 2)			= {1, 2, 3}
ORDERSTRICT(1)					= {1}
ORDERSTRICT(3, NaN, 2, NaN)		= {NaN, NaN, 2, 3}
ORDERSTRICT(NaN)				= {NaN}
ORDERSTRICT('Z', 'a', 'X')		= {'X', 'Z', 'a'}
ORDERSTRICT(“str1”, “STR2”, “stR1”} 		= {"STR2", "stR1", "str1"}
ORDERSTRICT(“str1”, NULL, “STR2”, “stR1”}	= {NULL, "STR2", "stR1", "str1"}

ORDERSTRICT(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {TIMESPAN(0,0,0,0,99), TIMESPAN(0,0,0,0,100)}
ORDERSTRICT(NULL, TIMESPAN(0,0,0,0,99)					= {NULL, TIMESPAN(0,0,0,0,99)}

ORDERINDEXSTRICT

Funkcia ORDERINDEXSTRICT triedi vstupné hodnoty vzostupne a namiesto hodnôt vráti kolekciu indexov, ktoré udávajú pozície pôvodných hodnôt v zoradenom poradí. Prijíma n hodnôt (až 100 argumentov) alebo jednu kolekciu. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Hodnoty NaN a NULL sú zahrnuté a sú vždy zoradené ako prvé.

ORDERINDEXSTRICT( n1, n2, n3 , … )
ORDERINDEXSTRICT( collection )

Príklady:

ORDERINDEXSTRICT(3, 1, 2)				= {1, 2, 0}
ORDERINDEXSTRICT(1)						= {0}
ORDERINDEXSTRICT(3, NaN, 2, NaN)		= {1, 3, 2, 0}
ORDERINDEXSTRICT(NaN)					= {0}
ORDERINDEXSTRICT('Z', 'a', 'X')			= {2, 0, 1}
ORDERINDEXSTRICT(“str1”, “STR2”, “stR1”}		= {1, 2, 0}
ORDERINDEXSTRICT(“str1”, NULL, “STR2”, “stR1”} 	= {1, 2, 3, 0}

ORDERINDEXSTRICT(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {1, 0}
ORDERINDEXSTRICT(NULL, TIMESPAN(0,0,0,0,99)					= {0, 1}

ORDERDESC

Funkcia ORDERDESC triedi vstupné hodnoty zostupne a vráti ich v novej kolekcii. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Hodnoty NaN a NULL sa ignorujú a nie sú zahrnuté vo výslednej kolekcii.

ORDERDESC( n1, n2, n3 , … )
ORDERDESC( collection )

Príklady:

ORDERDESC(3, 1, 2)					= {3, 2, 1}
ORDERDESC(1)						= {1}
ORDERDESC(3, NaN, 2, NaN)			= {3, 2}
ORDERDESC(NaN)						= {}
ORDERDESC('Z', 'a', 'X')			= {'a', 'Z', 'X'}
ORDERDESC(“str1”, “STR2”, “stR1”} 	= {"str1", "stR1", "STR2"}
ORDERDESC(“str1”, NULL, “STR2”, “stR1”} 	= {"str1", "stR1", "STR2"}

ORDERDESC(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)}
ORDERDESC(NULL, TIMESPAN(0,0,0,0,99)					= {TIMESPAN(0,0,0,0,99)}

ORDERINDEXDESC

Funkcia ORDERINDEXDESC triedi vstupné hodnoty zostupne a namiesto hodnôt vráti kolekciu indexov, ktoré udávajú pozície pôvodných hodnôt v zoradenom poradí. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Hodnoty NaN a NULL sa ignorujú a nie sú zahrnuté vo výslednej kolekcii.

ORDERINDEXDESC( n1, n2, n3 , … )
ORDERINDEXDESC( collection )

Príklady:

ORDERINDEXDESC(3, 1, 2)				= {0, 2, 1}
ORDERINDEXDESC(1)					= {0}
ORDERINDEXDESC(3, NaN, 2)			= {0, 2}
ORDERINDEXDESC(NaN)					= {}
ORDERINDEXDESC('Z', 'a', 'X')			= {1, 0, 2}
ORDERINDEXDESC(“str1”, “STR2”, “stR1”} 	= {0, 2, 1}
ORDERINDEXDESC(“str1”, NULL, “STR2”, “stR1”} 	= {0, 3, 2}

ORDERINDEXDESC(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {0, 1}
ORDERINDEXDESC(NULL, TIMESPAN(0,0,0,0,99)					= {1}

ORDERDESCSTRICT

Funkcia ORDERDESCSTRICT triedi vstupné hodnoty zostupne a vráti ich v novej kolekcii. Prijíma n hodnôt (až 100 argumentov) alebo jednu kolekciu. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Hodnoty NaN a NULL sú zahrnuté a vždy sú zoradené ako prvé.

ORDERDESCSTRICT( n1, n2, n3 , … )
ORDERDESCSTRICT( collection )

Príklady:

ORDERDESCSTRICT(3, 1, 2)			= {3, 2, 1}
ORDERDESCSTRICT(1)					= {1}
ORDERDESCSTRICT(3, NaN, 2, NaN)			= {NaN, NaN, 3, 2}
ORDERDESCSTRICT(NaN)				= {NaN}
ORDERDESCSTRICT('Z', 'a', 'X')					= {'a', 'Z', 'X'}
ORDERDESCSTRICT(“str1”, “STR2”, “stR1”} 		= {"str1", "stR1", "STR2"}
ORDERDESCSTRICT(“str1”, NULL, “STR2”, “stR1”} 	= {NULL, "str1", "stR1", "STR2"}

ORDERDESCSTRICT(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)}
ORDERDESCSTRICT(NULL, TIMESPAN(0,0,0,0,99)					= {NULL, TIMESPAN(0,0,0,0,99)}

ORDERINDEXDESCSTRICT

Funkcia ORDERINDEXDESCSTRICT triedi vstupné hodnoty zostupne, podobne ako ORDERDESC, avšak namiesto zoradených hodnôt vráti kolekciu indexov, ktoré udávajú pozície pôvodných hodnôt v zoradenom poradí. Hodnoty nemusia byť numerické, ale musia byť porovnateľné. Hodnoty NaN a NULL sú zahrnuté a vždy sú zoradené ako prvé.

ORDERINDEXDESCSTRICT( n1, n2, n3 , … )
ORDERINDEXDESCSTRICT( collection )

Príklady:

ORDERINDEXDESCSTRICT(3, 1, 2)				= {0, 2, 1}
ORDERINDEXDESCSTRICT(1)						= {0}
ORDERINDEXDESCSTRICT(3, NaN, 2, NaN)		= {1, 3, 0, 2}
ORDERINDEXDESCSTRICT(NaN)					= {0}
ORDERINDEXDESCSTRICT('Z', 'a', 'X')			= {1, 0, 2}
ORDERINDEXDESCSTRICT(“str1”, “STR2”, “stR1”}		= {0, 2, 1}
ORDERINDEXDESCSTRICT(“str1”, NULL, “STR2”, “stR1”} 	= {1, 0, 3, 2}

ORDERINDEXDESCSTRICT(TIMESPAN(0,0,0,0,100), TIMESPAN(0,0,0,0,99)	= {0, 1}
ORDERINDEXDESCSTRICT(NULL, TIMESPAN(0,0,0,0,99)						= {0, 1}