## array

Umożliwia dołączenie własnej specyfikacji typu kolumny i zmienia standardowe makropolecenia definiujące tabele: (`\tabular` i `\array`) -- na lepsze. Wskazane jest dołączenie pakietu w przypadku używania środowisk: `tabular`, `array`, `tabularx`, `longtable` i `supertabular`.

Definicja nowego typu kolumny:
`\newcolumntype{x }[n ]{preambuła }`
gdzie

x
  nazwa typu; używana potem w definicji preambuły tablicy
n
  liczba parametrów formalnych definicji rodzaju kolumny określonej specyfikacją (może być pominięte jeżeli definicja jest bezparametrowa; jeżeli paramatry występują, są one oznaczone jako: `#1` `#2`, ...),
preambuła
  definicja rodzaju kolumn.

W specyfikacji makropolecenia `\newcolumntype` oraz w definicji preambuły tablicy mogą być użyte następujące określenia (w preambule tablicy może znaleźć się oczywiście nowy, zdefiniowany poleceniem `\newcolumntype` typ).

l | dosunięcie tekstu do lewej
r | dosunięcie tekstu do prawej
c | centrowanie
m{width } | Definiuje kolumnę o szerokości width . Środek celi tej kolumny (połowa wysokości) pokrywa się ze środkiem celi kolumny sąsiedniej (porównaj; cela bieżąca i sąsiednia). Odpowiednik: `\parbox{width }`; tekst jest łamany na szerokości width .
p{width } | Równoważna: `\parbox[t]{width }`. Pozycjonowanie w/g szczytu celi.
b{width } | Równoważna `\parbox[b]{width }`. Pozycjonowanie w/g dołu celi.
>{macro } | Może być użyta przed jednym z następujących typów: `l`, `r`, `c`, `p`, `m` lub `b`. polecenie macro będzie wykonywana zawsze przed rozpoczęciem cel w tak określonej kolumnie.
<{macro } | Może być użyta po jednym z następujących typów: `l`, `r`, `c`, `p`, `m` lub `b`. Polecenie macro będzie wykonywana zawsze po zakończeniu cel w tak określonej kolumnie.
| | Wstawienie linii pionowej jako separatora kolumn; odległość między kolumnami zostanie zwiększona o szerokość linii (w odróżnieniu od oryginalnej definicji tabeli).
@{macro } | Może być użyte w dowolnym miejscu preambuły zamiast `|`. Polecenie macro zostanie wywołane między kolumnami (kasuje normalną odległość między kolumnami).
!{macro } | Może być użyte w dowolnym miejscu preambuły zamiast `|`. Polecenie macro zostanie wywołane między odpowiednimi kolumnami (w odróżnieniu od oryginalnej makroinstrukcji `@{...}` nie kasuje normalnej odległości między kolumnami).
*{n }{decl } | n -- krotne powtórzenie decl ; gdzie decl jest ciągiem poprzednio określonych parametrów. Np. `*{3}{c}` oznacza trzy kolumny centrowane.

Parametry którymi można regulować sposób budowania tabeli:

Polecenie | opis
--- | ---
`\arraycolsep` | połowa szerokości odstępu między kolumnami tablicy w środowisku matematycznym (`array`) (domyślnie 5pt)
`\tabcolsep` | połowa szerokości odstępu między kolumnami tablicy (domyślnie 6pt)
`\arrayrulewidth` | szerokość pionowej linii separującej kolumny (o ile jest używana -- domyślnie 0.4pt)
`\doublerulesep` | odległość między dwoma liniami pionowymi stanowiącymi separator kolumn (domyślnie 2pt)
`\arraystretch` | ,,mnożnik'' odstępu między wierszami tablicy (np. `\renewcommand{\arraystretch}{1.5}` zwiększa odstęp o 50%)
`\extrarowheight` | dodatkowy odstęp między liniami (domyślnie 0pt)

Uwaga
Niektóre polecenia (np. `\raggedright`) zmieniają definicje polecenia `\\`; tak więc specyfikacja typu ostatniej kolumny jako:
`>{\raggedleft}p{20mm}`
może spowodować błąd. Możemy temu zapobiec definiując makroinstrukcję odtwarzającą definicję polecenia `\\`
`\newcommand{\PreserveBackslash}[1]% {\let\temp=\\#1\let\\=\temp}`
`\let\PBS=\PreserveBackslash`
Argumentem pierwszego polecenia jest inne polecenie. Przed jego wykonaniem jest wykonywane makropodstawienie definicji `\\` na zmienną `\temp`, następnie wykonanie polecenia i odtworzenie poprzedniej definicji `\\` z zachowanej zmiennej `\temp`. Drugie polecenie utożsamia dla wygody (krótsza nazwa) zmienną `\PBS` z utworzonym poleceniem `\PreserveBackslash`. Poprawna definicja ostatniej kolumny będzie wyglądała teraz następująco:
`>{\PBS\raggedleft}p{20mm}`

Uwaga:
W związku z realizacją tabeli występuje efekt uboczny --- blokowane jest przenoszenie wyrazów (hyphenation) dla pierwszego wyrazu w celi. Efekt możemy skompensować wstawiając pustą przestrzeń o długości 0pt na początku celi (wykorzystując możliwości formowania preambuły tabeli) np.
`>{\PBS\raggedleft\hspace{0pt}}p{20mm}`

Pakiet jest dostępny standardowo w dystrybucjach LaTeX, a także pod adresem:
ftp://ftp.gust.org.pl/TeX/macros/latex/required/tools/array.dtx

Włodzimierz Macewicz

Ostatnie zmiany: 24.03.2003.