| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| en:create:functions:put [16.01.2015 19:07] – [Example: Calculations] alexander.ritter | en:create:functions:put [26.09.2020 14:32] – [put()] sophia.schauer |
|---|
| ====== put() ====== | ====== put() ====== |
| |
| ''void **put**(string //variable//, mixed //value//)'' | ''void **put**(string //variable//, mixed //value//, [boolean //EachVariable//])'' |
| |
| The function ''put'' enables you to store a single value in the data record. ''put()'' is used when the questionnaire calculates or draws a value -- and this value is needed for the analysis. For example, if the stimulus in a question is varied at random, then which one the respondent made a statement on has to be known for the analysis. | The function ''put'' enables you to store a single value in the data record. ''put()'' is used when the questionnaire calculates or draws a value -- and this value is needed for the analysis. For example, if the stimulus in a question is varied at random, then which one the respondent made a statement on has to be known for the analysis. |
| * //variable//\\ The ID of the internal variable (see below), in which the //value// should be saved. The ID is entered as a string in quotation marks, e.g. '''IV01_01'''. | * //variable//\\ The ID of the internal variable (see below), in which the //value// should be saved. The ID is entered as a string in quotation marks, e.g. '''IV01_01'''. |
| * //value//\\ A number or text (string), which should be stored in the variable. Ordinarily, a variable with the corresponding value is given as the second parameter. | * //value//\\ A number or text (string), which should be stored in the variable. Ordinarily, a variable with the corresponding value is given as the second parameter. |
| | * //EachVariable// (optional)\\ Normally, `put()` only stores in [[en:create:questions:internal|internal variables]]. In some cases it may be useful to overwrite the value of another variable. In this case a third parameter ''true'' can be specified. |
| | |
| | **Warning:** Only use the third parameter //EachVariable// if you know exactly what you are doing and an internal variable cannot be used. Changing response codes can invalidate the validity of the data set. For most cases the functions ''[[:en:create:functions:preset]]'' and ''[[:en:create:functions:dropvalue]]'' are much better suited. |
| | |
| |
| |
