Test whether a character string is a CQP query, or turn a character vector into CQP queries.
is.cqp(query)
check_cqp_query(query, warn = TRUE)
as.cqp(
query,
normalise.case = FALSE,
collapse = FALSE,
check = TRUE,
warn = TRUE
)A character vector with at least one CQP query.
A (length-one) logical value, whether to issue a warning if a
query may be buggy.
A logical value, if TRUE, a flag will be
added to the query/queries to omit matching case.
A logical value, whether to collapse the queries into one.
A logical value whether to run check_cqp_query() on queries.
is.cqp returns a logical value, as.cqp a character
vector, check_cqp_query a logical value that is TRUE if all
queries are valid, or FALSE if not.
The is.cqp() function guesses whether query is a CQP query
and returns the respective logical value (TRUE/FALSE).
The as.cqp() function takes a character vector as input and converts it
to a CQP query by putting the individual strings in quotation marks.
The check_cqp_query-function will check that opening
quotation marks are matched by closing quotation marks, to prevent crashes
of CQP and the R session.
CQP Query Language Tutorial (https://cwb.sourceforge.io/files/CQP_Tutorial.pdf)
is.cqp("migration") # will return FALSE
#> [1] FALSE
is.cqp('"migration"') # will return TRUE
#> [1] TRUE
is.cqp('[pos = "ADJA"] "migration"') # will return TRUE
#> [1] TRUE
as.cqp("migration")
#> [1] "\"migration\""
as.cqp(c("migration", "diversity"))
#> [1] "\"migration\"" "\"diversity\""
as.cqp(c("migration", "diversity"), collapse = TRUE)
#> [1] "(\"migration\"|\"diversity\")"
as.cqp("migration", normalise.case = TRUE)
#> [1] "\"migration\" %c"
check_cqp_query('"Integration.*"') # TRUE, the query is ok
#> "Integration.*"
#> TRUE
check_cqp_query('"Integration.*') # FALSE, closing quotation mark is missing
#> Warning: An issue occurred when checking query: "Integration.*
#> Number of quotation marks is not divisable by 2: Opening quotation marks are not matched by closing quotation marks, or vice versa. Aborting to avoid a potential crash of CQP and the entire R session. Please check query. If this is a false positive, omit check of the query syntax by setting argument `check` to `FALSE`.
#> "Integration.*
#> FALSE
check_cqp_query("'Integration.*") # FALSE, closing quotation mark is missing
#> Warning: An issue occurred when checking query: 'Integration.*
#> Number of quotation marks is not divisable by 2: Opening quotation marks are not matched by closing quotation marks, or vice versa. Aborting to avoid a potential crash of CQP and the entire R session. Please check query. If this is a false positive, omit check of the query syntax by setting argument `check` to `FALSE`.
#> 'Integration.*
#> FALSE
check_cqp_query(c("'Integration.*", '"Integration.*')) # FALSE too
#> Warning: An issue occurred when checking query: 'Integration.*
#> Number of quotation marks is not divisable by 2: Opening quotation marks are not matched by closing quotation marks, or vice versa. Aborting to avoid a potential crash of CQP and the entire R session. Please check query. If this is a false positive, omit check of the query syntax by setting argument `check` to `FALSE`.
#> Warning: An issue occurred when checking query: "Integration.*
#> Number of quotation marks is not divisable by 2: Opening quotation marks are not matched by closing quotation marks, or vice versa. Aborting to avoid a potential crash of CQP and the entire R session. Please check query. If this is a false positive, omit check of the query syntax by setting argument `check` to `FALSE`.
#> 'Integration.* "Integration.*
#> FALSE FALSE