More actions
jrfconvert import |
|||
(8 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
[[Category: | = DCS_evaluateWhereExpression = | ||
[[Category:Data_Cache_Functions]] | |||
__NOTOC__ | |||
Evaluate a WHERE expression. See also [[DCS evaluateWhereExpressions]] for faster evalution of multiple expressions. | |||
This function is an alias to EvalWhere in [[DataCacheSpecification class]]. | |||
=== Syntax === | |||
DCS_evaluateWhereExpression(whereExpression) | |||
=== Arguments === | |||
*whereExpression: is string. ex: "selectColumn(Id) where true;" | |||
=== Return value === | |||
Execute the where expression and return an object depending on where expression: | |||
{| class="tableintopic" style="border-collapse: collapse; border: 1px solid #010101" width="438" cellpadding="2" border="1" | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" bgcolor="#C0C0C0" | | |||
'''WhereExpression''' | |||
=== | | style="border: 1px solid #010101" width="222" bgcolor="#C0C0C0" | | ||
'''Return type''' | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
average | |||
| style="border: 1px solid #010101" width="222" | | |||
empty | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
count | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
max | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
median | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
min | |||
number | | style="border: 1px solid #010101" width="222" | | ||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
percentile | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
quantile | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
select | |||
| style="border: 1px solid #010101" width="222" | | |||
empty | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
selectColumn | |||
| style="border: 1px solid #010101" width="222" | | |||
array | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
stdev | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
sterr | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
sum | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|- valign="top" align="left" | |||
| style="border: 1px solid #010101" width="216" | | |||
variance | |||
| style="border: 1px solid #010101" width="222" | | |||
number | |||
|} | |||
===== Example ===== | |||
''number dcsResourceId1 = DCS_getCurrentDcsResourceId(); '' | |||
''number dcsResourceId2 = 123456; '' | |||
''string expression1 = "average(Single2) where true;"; '' | |||
''string expression2 = "min(Single2) where true;"; '' | |||
''DCS_use(dcsResourceId2); '' | |||
''print(DCS_evaluateWhereExpression(expression1)); //return average value of question Single2 '' | |||
''print(DCS_evaluateWhereExpression(expression2)); //return minimum value of question Single2 '' |
Latest revision as of 08:57, 5 December 2018
DCS_evaluateWhereExpression
Evaluate a WHERE expression. See also DCS evaluateWhereExpressions for faster evalution of multiple expressions.
This function is an alias to EvalWhere in DataCacheSpecification class.
Syntax
DCS_evaluateWhereExpression(whereExpression)
Arguments
- whereExpression: is string. ex: "selectColumn(Id) where true;"
Return value
Execute the where expression and return an object depending on where expression:
WhereExpression |
Return type |
average |
empty |
count |
number |
max |
number |
median |
number |
min |
number |
percentile |
number |
quantile |
number |
select |
empty |
selectColumn |
array |
stdev |
number |
sterr |
number |
sum |
number |
variance |
number |
Example
number dcsResourceId1 = DCS_getCurrentDcsResourceId();
number dcsResourceId2 = 123456;
string expression1 = "average(Single2) where true;";
string expression2 = "min(Single2) where true;";
DCS_use(dcsResourceId2);
print(DCS_evaluateWhereExpression(expression1)); //return average value of question Single2
print(DCS_evaluateWhereExpression(expression2)); //return minimum value of question Single2