In AnQiCMS template development, we often need to combine different data fragments, whether it is the calculation of numbers or the integration of text information. Among them,addA filter is a very practical and flexible tool that can help us easily perform the "addition" operation of two variable values, achieving a seamless splicing effect.

addThe design concept of the filter is to balance numerical operations and string concatenation.When you apply it to two numeric variables, it performs standard mathematical addition to calculate their sum.For example, if you have two variables representing quantities, you need to calculate the total,addThe filter can be used.

However,addThe power of the filter goes beyond this. It can also intelligently handle strings.When both operands are strings, it acts like glue, tightly connecting them together to form a new string.This is especially convenient when building dynamic text content, such as custom messages, file paths, or combined titles.

What's more worth mentioning is,addThe filter has a certain ability for intelligent type conversion. Even if you try to add a number with a string, the system will try to perform a reasonable type conversion to complete the operation.In most cases, numbers are converted to strings and then concatenated with another string.This flexible mechanism reduces the麻烦 of manual type conversion in templates, making content creation smoother.

If involvedaddOne of the variables in the operation does not exist (such asnothing) or it is a null value (such asnil)addThe filter will not fail due to this. It will show good error tolerance, quietly ignoring this invalid part, processing only the valid values, ensuring the stability and predictability of the output results.

addFilter usage

In the AnQiCMS template,addThe syntax of using filters is very intuitive:

{{ 值1|add:值2 }}

Here值1and值2Can be a variable in the template, or a directly written literal (such as numbers, strings).

Practical exercise: Example of diverse concatenation

In order to understand betteraddThe function of the filter, we demonstrate it through some specific examples how it handles different types of data:

  1. Add numbers:

    When you need to calculate the sum of two numbers,addThe filter performs standard mathematical addition.

    {{ 5|add:2 }}
{{ 5|add:40 }}

    Output Result:

    7
47

  2. Adding a number to a null value:

    If one of the values is null (nothing)addThe filter will ignore it and only return valid values.

    {{ 5|add:nothing }}

    Output Result:

    5

  3. Concatenating a number with a string:

    When a number is used with a string, the number is usually converted to a string and then concatenated.

    {{ 5|add:"CMS" }}
{{ 5|add:"2" }}

    Output Result:

    5CMS
52

    As you can see,5|add:"2"No mathematical addition was performed to get7but instead, it was5concatenated with a string"2"to get the result."52"This indicates that when a string appears,addthe filter tends to behave in a string concatenation manner.

  4. string concatenation:

    two strings pass throughaddthe filter can connect seamlessly.

    {{ "安企"|add:"CMS" }}

    Output Result:

    安企CMS

  5. String concatenation with numbers (as strings):

    {{ "安企"|add:"2" }}

    Output Result:

    安企2

By these examples, we can clearly seeaddThe filter exhibits flexible behavior when processing different types of data. It is not only capable of completing basic numerical operations but also provides a concise and efficient solution for string concatenation, and even intelligently handles mixed type data.

Frequently Asked Questions (FAQ)

  1. Q:addCan the filter only be used for string concatenation?A: No.addThe filter is designed to be very flexible, it can perform addition operations on numbers as well as be used for string concatenation.Even when using numbers and strings together, it tries to intelligently convert numbers to strings and then concatenate them to provide a more convenient operation experience.

  2. Q: If I try to useaddThe filter concatenates a non-existent variable (for examplenothingornil), what will happen?A:addThe filter has a good error-tolerant mechanism for such situations. If one of the values involved in the 'addition' does not exist (such asnothing) or it is a null value (such asnil)，it will silently ignore this invalid value and only process the existing one. For example,{{ 5|add:nothing }}The output result is still5.

  3. Q:addFilter and write directly in the template{{ 变量1 }}{{ 变量2 }}What is the difference in concatenating strings?A:{{ 变量1 }}{{ 变量2 }}This is a pure string concatenation, without any type conversion, it directly connects the string representations of two variables. AndaddThe filter is smarter, it tries to perform type conversion to achieve addition operations on numbers, or to concatenate strings when numbers and strings are mixed.This intelligent transformation provides greater convenience and flexibility when dealing with mixed data types, especially when you want numbers to participate in calculations rather than just be displayed as strings.