Skip to main content

Functions: store_value and get_value

Adding calculated variables to your survey

Updated over 3 weeks ago

When and Why to Use

Use these to save and retrieve values for use in survey logic or reporting.

• store_value() lets you assign a value (like a derived age or score) to a named variable

• get_value() retrieves that value later in the survey for use in branching, filtering, or display

Common use cases include:

• Calculating age from birth year

• Storing a derived score

store_value(name, value, **topics)

Parameter

Type

Required

Description

name

str

yes

Name to assign to the stored value

value

str or int

yes

Value to store, often calculated from a previous answer

**topics

dict

no

Used for grouping and metadata in reporting

get_value(name)

Parameter

Type

Required

Description

name

str

yes

Name of the value to retrieve

Returns: The stored value (any type)

Example Code

from datetime import datetime from survey import Survey s = Survey(**globals()) birth_year = s.numeric_question("What year were you born in?", min_max=(1920, 2020)) s.store_value("age", datetime.now().year - birth_year) s.terminate_if( s.get_value("age") < 18, "Sorry, this survey is for adults 18 and older." )

Notes

• store_value can be used multiple times to keep track of intermediate calculations

• Values can be used in logic, shown in text, or passed to external APIs

• You can apply topics for each stored value to categorize them in your reporting schema

Did this answer your question?