Generates a query expression for matching a multi-value transcript/participant attribute, for use with getMatches

This function generates a query expression fragment which can be passed as the transcript.expression or participant.expression parameter of getMatches, (or the expression parameter of getMatchingTranscriptIds or getMatchingParticipantIds) using a list of possible values for a given transcript attribute.

Usage

expressionFromAttributeValues(transcript.attribute, values, not = FALSE)

Arguments

transcript.attribute

The transcript attribute to filter by.

values

A list of possible values for transcript.attribute.

not

Whether to match the given IDs (FALSE), or everything except the given IDs.

Value

A transcript query expression which can be passed as the transcript.expression parameter of getMatches or the expression parameter of getMatchingTranscriptIds

Details

The attribute defined by transcript.attribute is expected to have possibly more than one value. If it can have only one value, use expressionFromAttributeValue instead.

See also

expressionFromAttributeValue

expressionFromTranscriptTypes

expressionFromIds

getMatches

Examples

if (FALSE) { # \dontrun{
## Perform a search
languages <- c("en","es")
results <- getMatches(labbcat.url, list(segment="I"),
                      participant.expression = expressionFromAttributeValues(
                            "participant_languagesSpoken", languages))
} # }