How does the `add` filter handle the addition/pasting operation with boolean values `true` and `false` as well as numbers or strings?

In Anqi CMS template development, we often need to process and display data. Among them,addA filter is a very practical tool that allows us to add numbers, concatenate strings. However, when dealing with boolean valuestrueandfalseWhen involved in these operations, their behavior may be curious to some new users.

Today, let's delve deeper into it.addHow the filter handles the addition/pasting operation between boolean values and numbers or strings.

addFilter: Flexible handling of numbers and strings.

First, let's reviewaddThe basic function of the filter. In Anqi CMS templates,addThe filter is very intelligent, it can perform corresponding operations according to the type of operands:

• Add numbers:When all operands are numbers,addThe filter performs standard mathematical addition.

  
  {{ 5|add:2 }}  {# 输出: 7 #}
  {{ 10.5|add:3.2 }} {# 输出: 13.7 #}
  

• string concatenation:When the operand contains a string,addthe filter will concatenate them.

  
  {{ "安企"|add:"CMS" }} {# 输出: 安企CMS #}
  

• Mixed type handling:Even if the operand is a mixed type,addThe filter also tries to perform type conversion to complete the operation. For example, when a number is concatenated with a string, the number is converted to a string.

  
  {{ "安企"|add:"2" }} {# 输出: 安企2 #}
  {{ 5|add:"CMS" }}   {# 输出: 5CMS #}
  

  It is worth noting that if the type conversion fails,addFilters usually 'ignore' content that cannot be converted, only processing the parts that are successfully converted. For example,{{ 5|add:nothing }}It will output.5becausenothingcannot be added or concatenated effectively.

Booleantrueandfalseof 'Metamorphosis'

Now, let's focus on boolean valuestrueandfalse. In the Anqi CMS template environment, when boolean values are involved inaddWhen performing filter operations, they will undergo a直观 transformation based on the context:

1. When added to numbers:

   • truewill be treated as numbers1.
   • falsewill be treated as numbers0This is consistent with the practice of many programming languages and template engines, and the purpose is to facilitate simple conditional counting or mathematical operations.

   Let's see some examples:

   {{ true|add:5 }}    {# 输出: 6 (因为 true 被当作 1) #}
   {{ false|add:10 }}  {# 输出: 10 (因为 false 被当作 0) #}
   {{ 100|add:true }}  {# 输出: 101 (同样，true 被当作 1) #}
   {{ 200|add:false }} {# 输出: 200 (同样，false 被当作 0) #}
   

2. When concatenated with a string:

   • trueis converted to a string"true".
   • falseis converted to a string"false". This conversion is also to maintain the intuitiveness of the operation, ensuring that boolean values can be integrated into strings in their text form.

   For example:

   {{ "AnQiCMS 版本: "|add:true }}   {# 输出: AnQiCMS 版本: true #}
   {{ "网站状态: "|add:false }}      {# 输出: 网站状态: false #}
   {{ true|add:" 已启用" }}         {# 输出: true 已启用 #}
   {{ false|add:" 未启用" }}        {# 输出: false 未启用 #}
   

Considerations in practical applications.

UnderstandingaddThe filter handles boolean values, which can help us build dynamic content more flexibly.For example, displaying the enabled status of a feature in a table or performing simple numerical summation based on the value of a boolean variable.

AlthoughaddThe filter provides this flexible automatic type conversion, but we still recommend:

• Keep it clear:If you need to perform complex logical judgments or numerical conversions, it is best to useiftags or clearer variable assignments to preprocess boolean values rather than over-rely onaddimplicit conversion of filters.
• Test is for the king:Before releasing any complex template code, it is essential to perform thorough testing to ensureaddThe behavior of the filter meets expectations under various data type combinations.

In short, the Anqi CMS'saddThe filter follows a practical and user-friendly principle when dealing with boolean values: when added to numbers, booleans become0or1; and when concatenated with strings, they act as"true"or"false"It appears in the form. Mastering these "secrets" will make your Anqi CMS template development more skillful.

Frequently Asked Questions (FAQ)

1.addCan the filter add two boolean values together? For example{{ true|add:true }}What will be output?Answer: WhenaddThe filter tries to add two boolean values together, and it will first convert them to numbers. So,trueWill become1,falseWill become0Thus,{{ true|add:true }}It will output.2(that is,}1 + 1) while,{{ true|add:false }}It will output.1(that is,}1 + 0).

2.addWhat will the filter do when it encounters a null value (such as)nilornothing)?Answer: As mentioned in the article, whenaddThe filter will 'ignore' the null values that cannot be effectively converted to numbers or strings for addition or concatenation and will only process the valid operands. For example,{{ 5|add:nothing }}It will output.5,{{ "文本"|add:nil }}It will output."文本".

3.addThe filter is only applicable to variables in the template, or is it also applicable to literal values written directly?Answer:addThe filter can act on both variables in the template and literal values (such as5/"字符串"/trueAs long as the operand is a valid type, the filter will work normally. For example,{{ 10|add:20 }}and{% set num = 10 %}{{ num|add:20 }}will be output normally.30.