getHearings {washex}

Get hearings regarding a bill

Description

Get a list of dates, locations, and descriptions of all committee hearings on a particular bill

Usage

getHearings(biennium, billNumber, paired = TRUE, type = c("df", "list", "xml"))

Arguments

biennium

Character vector representing the biennium(s) to be searched. Each argument should take the form "XXXX-YY"

billNumber

Character or numeric vector containing the bill number(s) to be retrieved.

paired

If TRUE, will assume that equal length vectors represent paired data. Set to FALSE to generate an NxN grid of input arguments. Applies to equal length vector inputs only.

type

One of "df", "list", or "xml". Specifies the format for the output.

Value

getHearings returns an object of type equal to the type argument (defaults to dataframe)

Note

Due to the nature of the resulting XML document, the function trims data from excessively nested lists when type = "df". In order to access the full information, use type = "list" instead.

Examples

## get hearings for all senate bills in 2011
bills <- getLegislationByYear("2011")
if(!is.null(bills)) billsSenate <- subset(bills, OriginalAgency == "Senate")

## Not run: getHearings(billsSenate$Biennium, billsSenate$BillNumber, paired = TRUE, type = "df")