{"id":3503,"date":"2022-11-21T09:37:46","date_gmt":"2022-11-21T09:37:46","guid":{"rendered":"https:\/\/info.documotor.com\/?page_id=3503"},"modified":"2023-01-25T10:18:43","modified_gmt":"2023-01-25T10:18:43","slug":"if","status":"publish","type":"page","link":"https:\/\/info.documotor.com\/?page_id=3503","title":{"rendered":"If"},"content":{"rendered":"\n

The if function can be used to output a specific output or other transformation, based on the evaluation of a boolean value. <\/p>\n\n\n\n

Syntax<\/h3>\n\n\n\n
any if(any $condition, any $trueValue, any $falseValue)<\/code><\/pre>\n\n\n\n
Parameters<\/h3>\n\n\n\n
$condition:<\/strong> The boolean value that should be evaluated upon. A boolean value always returns either true<\/code> or false<\/code>, based on the comparison operator. It evaluates as a truthy<\/a><\/em> whereas a non-empty string will evaluate as true. The condition can be set by the operators below: <\/p>\n\n\n\n
! <\/td>NOT<\/td>The not operator is used to check if a variable is not true. In other words, it checks boolean values of a statement. This could be e.g., to check if a variable exists or not.<\/td><\/tr>
!=<\/td>Not Equal<\/td>The not equal is usually used to check if a value is not equal (a != b)<\/td><\/tr>
&&<\/td>AND<\/td>If you want two or more variables to both be true, you use the && operator<\/td><\/tr>
||<\/td>OR<\/td>Use this operator if you want just one of more values to be true <\/td><\/tr>
<<\/td>Less than<\/td>Check if one value is less than some other value<\/td><\/tr>
><\/td>Greater than<\/td>Check if one value is greater than another<\/td><\/tr>
==<\/td>Equals<\/td>Check if two values are equal to each other<\/td><\/tr>
<=<\/td>Less than or Equal<\/td>Check if a value is less than or equal to each other<\/td><\/tr>
>=<\/td>Greater than or Equal<\/td>Check if a value is greater than or equal to each other<\/td><\/tr>
?<\/td>Filter Expression<\/td>This is used to filter an array<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
$trueValue: <\/strong>The value that should be returned if $condition is true. Can also be a transformation. <\/p>\n\n\n\n
$falseValue: <\/strong>The value that should be returned if $condition is false. Can also be a transformation.<\/p>\n\n\n\n
Example<\/h2>\n\n\n\n
{\n    \"a\": \"Test\",\n    \"b\": true,\n    \"c\": \"\",\n    \"d\": null,\n    \"e\": false\n}<\/code><\/pre>\n\n\n\n
{\n    alpha: if(a, 'Evaluates true', 'Evaluates false'),\n    beta: if(b, 'Evaluates true', 'Evaluates false'),\n    charlie: if(c, 'Evaluates true', 'Evaluates false'),\n    delta: if(d, 'Evaluates true', 'Evaluates false'),\n    echo: if(e, 'Evaluates true', 'Evaluates false'),\n    foxtrot: if(a == 'Test', 'Evaluates true', 'Evaluates false')\n}<\/code><\/pre>\n\n\n\n
{\n    \"alpha\": \"Evaluates true\",\n    \"beta\": \"Evaluates true\",\n    \"charlie\": \"Evaluates false\",\n    \"delta\": \"Evaluates false\",\n    \"echo\": \"Evaluates false\",\n    \"foxtrot\": \"Evaluates true\"\n}<\/code><\/pre>\n\n\n\n
In this example, the values evaluate either true or false. Specifically, it returns either the string “Evaluates true” or “Evaluates false.” Note how the final transformation, “foxtrot,” makes a comparison, and asks whether or not “a” is the same as the value “Test.” Also, the empty string and null value make the if function evaluates as false, for example, “charlie” and “delta.” <\/p>\n\n\n\n
Notes<\/h3>\n\n\n\n
Error handling<\/strong><\/p>\n\n\n\n
The if function is useful for error handling a transformation. For example, if an input is expected to be an array, and some array-specific operations is supposed to be executed on the input, it would be beneficial  to encapsulate the operation with an if like if(arr1 == to_array(arr1), to_array(arr1), split_array(arr1, 2<\/code>), '')<\/code>, where the false output would give an empty string, instead of an error. <\/p>\n","protected":false},"excerpt":{"rendered":"
The if function can be used to output a specific output or other transformation, based on the evaluation of a boolean value. Syntax Parameters $condition: The boolean value that should be evaluated upon. A boolean value always returns either true or false, based on the comparison operator. It evaluates as a truthy whereas a non-empty […]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":271,"menu_order":80,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/3503"}],"collection":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3503"}],"version-history":[{"count":12,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/3503\/revisions"}],"predecessor-version":[{"id":3906,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/3503\/revisions\/3906"}],"up":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/271"}],"wp:attachment":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3503"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}