ID EN
Environment & Scope

parse

R Base 3.6.2 🇮🇩 Bahasa Indonesia

parse() mengembalikan ekspresi yang diuraikan tetapi tidak dievaluasi dalam sebuah ekspresi, sebuah "daftar" panggilan. str2expression(s) dan str2lang(s) mengembalikan versi khusus parse(text=s, keep.source=FALSE) dan oleh karena itu dapat dianggap sebagai transformasi string karakter s menjadi ekspresi, panggilan, dll.

Syntax

R
parse(file = "", n = NULL, text = NULL, prompt = "?",
      keep.source = getOption("keep.source"), srcfile,
      encoding = "unknown")<p></p><p>str2lang(s)
str2expression(text)</p>

Arguments

Parameter Deskripsi
file a connection, or a character string giving the name of a file or a URL to read the expressions from. If file is "" and text is missing or NULL then input is taken from the console.
n integer (or coerced to integer). The maximum number of expressions to parse. If n is NULL or negative or NA the input is parsed in its entirety.
text character vector. The text to parse. Elements are treated as if they were lines of a file. Other R objects will be coerced to character if possible.
prompt the prompt to print when parsing from the keyboard. NULL means to use R's prompt, getOption("prompt").
keep.source a logical value; if TRUE, keep source reference information.
srcfile NULL, a character vector, or a srcfile object. See the ‘Details’ section.
encoding encoding to be assumed for input strings. If the value is "latin1" or "UTF-8" it is used to mark character strings as known to be in Latin-1 or UTF-8: it is not used to re-encode the input. To do the latter, specify the encoding as part of the connection con or via options(encoding=): see the example under file.
s a character vector of length 1, i.e., a “string”.

Return Value

parse() dan str2expression() mengembalikan objek bertipe "ekspresi", untuk parse() dengan maksimal n elemen jika ditentukan sebagai bilangan bulat non-negatif. str2lang(s), s sebuah string, mengembalikan “panggilan atau yang lebih sederhana”, lihat bagian 'Detail:'. Ketika srcfile bukan NULL, atribut "srcref" akan dilampirkan ke hasil yang berisi daftar catatan srcref yang sesuai dengan setiap elemen, atribut "srcfile" akan dilampirkan yang berisi salinan srcfile, dan atribut "wholeSrcref" akan dilampirkan berisi sr

Details

parse(....): Jika teks memiliki panjang lebih besar dari nol (setelah paksaan), teks tersebut digunakan sebagai preferensi daripada file. Semua versi R menerima input dari koneksi dengan akhir baris yang ditandai dengan LF (seperti yang digunakan pada Unix), CRLF (seperti yang digunakan pada DOS/Windows) atau CR (seperti yang digunakan pada Mac OS klasik). Baris terakhir mungkin tidak lengkap, karena tidak ada penanda EOL terakhir. Ketika input diambil dari konsol, n = NULL setara dengan n = 1, dan n < 0 akan dibaca hingga karakter EOF dibaca. (Karakter EOF adalah Ctrl-Z untuk front-end Windows.) Batas panjang baris adalah 4095 byte saat membaca dari konsol (yang mungkin menerapkan batas bawah: lihat 'Pengantar R'). Default untuk srcfile diatur sebagai berikut. Jika keep.source tidak BENAR, srcfile defaultnya adalah string karakter, baik "<teks>" atau yang berasal dari file. Kapan

Contoh

Example
R
# NOT RUN {
fil <- tempfile(fileext = ".Rdmped")
cat("x <- c(1, 4)\n  x ^ 3 -10 ; outer(1:7, 5:9)\n", file = fil)
# parse 3 statements from our temp file
parse(file = fil, n = 3)
unlink(fil)

## str2lang(<string>)  || str2expression(<character>) :
stopifnot(exprs = {
  identical( str2lang("x[3] <- 1+4"), quote(x[3] <- 1+4))
  identical( str2lang("log(y)"),      quote(log(y)) )
  identical( str2lang("abc"   ),      quote(abc) -> qa)
  is.symbol(qa) & !is.call(qa)           # a symbol/name, not a call
  identical( str2lang("1.375" ), 1.375)  # just a number, not a call
})

# A partial parse with a syntax error
txt <- "
x <- 1
an error
"
sf <- srcfile("txt")
try(parse(text = txt, srcfile = sf))
getParseData(sf)
# }

See Also

scan source eval deparse. The source reference information can be used for debugging (see e.g.setBreakpoint) and profiling (see Rprof). It can be examined by getSrcref and related functions. More detailed information is available through getParseData.