Základy informatiky pro biologyCvičebnice jazyka R Dokumentace k základním funkcím cat

Cvičebnice jazyka R |

cat

Sloučit a vytisknout

cat {base}

Dokumentace R v češtině

Popis

Výstupem jsou objekty, slučující reprezentace. cat dělá mnohem méňe konverzí než print.

Použití

cat(... , file = "", sep = " ", fill = FALSE, labels = NULL, append = FALSE)

Argumenty

`...`	R objekty (viz. ‘Detaily’ pro povolené typy objektů).
`file`	connection, nebo znakový řetězec, který jmenuje soubor, do kterého tisknout. Jestli `""` (přednastavené), `cat` vytiskne do standardní výstupní connection, konzole, pokud není přesměrován pomocou `sink`. Jestli to je `"\|cmd"`, výstup je vedený do příkazu zadaného pomocou ‘cmd’, tím, že otevře cestu ku connection.
`sep`	znakový vektor řetězců, který se má připojit po každém elementu.
`fill`	a logical anebo (kladný) číselný typ, který kontroluje jak je výstup rozložen do po sebe jdoucích řádků. Jestli je `FALSE` (přednastavené), jsou vytisknuté jenom nové řádky vytvořeny explicitně pomocou "n". Jinak je výstup rozložen do řádků s tiskovou šířkou rovnou možnosti `width` jestli je `fill` `TRUE`, nebo hodnotě `fill` pokud je číselného typu. `fill` hodnoty, které nejsou pozitivním jsou ignorovány, s varováním.
`labels`	znakový vektor štítků pro vytisknuté řádky. Ignorován, jestli je `fill` `FALSE`.
`append`	logical. Použité jenom tehdy, kdy je argument `file` název souboru (a ne connection anebo `"\|cmd"`). Jestli je `TRUE` výstup bude připojen k `file`; v opačném případě přepíše obsah `file`.

Detaily

cat je užitečný pro vyrábění výstupu v užívatelem-definovaných funkcích. Konvertuje argumenty na znakové vektory, slučuje je do jednoho znakového vektoru, připájí daný sep = řetězec/-ce ku každému elementu a pak je vrací.

Žádné řádky nejsou výstupem, dokud o ně není explicitně požádáno použitím "n" nebo nejsou vygenerovány pomocou fill (jestli je argument fill TRUE nebo číselný typ).

Jestli je file connection je otevřen pro psaní, je do něho psáno od jeho aktuální pozice. Jestli není otevřen, otevře se na trvání volání ve "wt" mode a pak se znovu zavře.

Momentálně pracuje jenom s atomic vektory a name, spolu s NULL a jinými objekty nulové délky (které neprodukují žádný výstup). Znakové řetězce jsou výstupem ‘jak jsou’ (oproti print.default, kterému unikají netisknutelné znaky a lomítko — použijte encodeString jestli chcete vrátit zakódované řetězce s použitím cat). Ostatní typy R objektů by měli být konvertované (např., pomocou as.character nebo format) předtím, jak jsou předány cat. To zahrnuje faktory, které jsou výstupem jako integer vektory.

cat konvertuje numerické/komplexní elementy rovnakým způsobem jako print (a ne rovnakým způsobem jako as.character který je používán S ekvivalentem), takže možnosti "digits" a "scipen" jsou relevantní. Avšak, používá minimální šířku pole, která je nutná pro každý element, namísto používání rovnaké šířky pole pro všechny elementy.

Hodnota

Žádná (neviditelná NULL).

Poznámka

Jestli nějaký element sep obsahuje znak pro nový řádek, je ošetřený jako vektor terminátorů namísto separátorů, přičemž výstupem je element po každém vektorovém elementu a nový řádek po posledním. Vstupy jsou recyklovány dle potřeby.

Reference

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.

Viz také

print, format, a paste, které slučuje do řetězce.

Příklady

iter <- stats::rpois(1, lambda = 10)
## vytiskni informativní zprávu cat("iteration = ", iter <- iter + 1, "n")
## 'fill' a štítky řádků: cat(paste(letters, 100* 1:26), fill = TRUE, labels = paste0("{", 1:10, "}:"))

vytvořil Institut biostatistiky a analýz Lékařské fakulty Masarykovy univerzity