rddi (version 0.1.1)

ddi_qstn: qstn and its child nodes

Description

• ddi_qstn() is the question asked. The element may have mixed content. The element itself may contain text for the question, with the subelements being used to provide further information about the question. Alternatively, the question element may be empty and only the subelements used. The element has a unique question ID attribute which can be used to link a variable with other variables where the same question has been asked. This would allow searching for all variables that share the same question ID, perhaps because the questions was asked several times in a panel design.

Usage

ddi_qstn(...)
ddi_backward(...)
ddi_forward(...)
ddi_ivuInstr(...)
ddi_postQTxt(...)
ddi_preQTxt(...)
ddi_qstnLit(...)

Value

A ddi_node object.

Arguments

...

Child nodes or attributes.

Details

#' Parent nodes

qstn is contained in var.

qstn specific child nodes

• ddi_backward() contains a reference to IDs of possible preceding questions. The "qstn" IDREFS may be used to specify the question IDs.

• ddi_forward() contains a reference to IDs of possible following questions. The "qstn" IDREFS may be used to specify the question IDs.

• ddi_ivuInstr() are specific instructions to the individual conducting an interview.

• ddi_postQTxt() is the text describing what occurs after the literal question has been asked.

• ddi_preQTxt() is the pre-question text. This is the text describing a set of conditions under which a question might be asked.

• ddi_qstnLit() is the text of the actual, literal question asked.

References

qstn documentation

backward documentation

forward documentation

ivuInstr documentation

postQTxt documentation

preQTxt documentation

qstnLit documentation

Examples

ddi_qstn("When you get together with your friends, would you say you discuss 
political matters frequently, occasionally, or never", ID = "Q125")

# Functions that need to be wrapped in ddi_qstn()

# Including ddi_preQTxt within a ddi_qstn with content
ddi_qstn("When you get together with your friends, would you say you discuss 
political matters frequently, occasionally, or never", ID = "Q125",
         ddi_preQTxt("For those who did not go away on a holiday of four days or more in 1985..."))

ddi_qstn(ddi_postQTxt("The next set of questions will ask about your financial situation")) 

# Using IDREFS in ddi_backward() and ddi_forward()

ddi_backward(qstn = "Q143")

ddi_forward("If yes, please ask questions 120-124", qstn = "Q120 Q121 Q122 Q123 Q124")

# Other child elements

ddi_ivuInstr("Please prompt the respondent if they are reticent to answer this question.", 
              lang = "en")

ddi_qstnLit("Why didn't you go away in 1985?")