When using AnQi CMS for template development, we often encounter situations where we need to combine, concatenate, or sum multiple variables. Among them,addThe filter is a very practical tool that allows us to perform addition operations on numbers or concatenate strings. However, some users may be curious,addDoes the filter support similar{{ var1|add:var2|add:var3 }}such chaining calls to concatenate multiple variables at once?

After getting a deep understanding of the template syntax of Anqi CMS, we find that its template engine is very similar to Django's syntax, which means that filters are usually applied in order to the result of the previous operation. But foraddA filter, its design intention and usage is more focused on processing two operands.

addThe principle of the filter.

According to the official documentation of Anqi CMS,addThe basic function of a filter is to add two numbers or concatenate two strings. Its typical usage is{{ obj|add:obj2 }}.

For example, if you want to add5and2numbers, you would write{{ 5|add:2 }}The result is7. If you want to concatenate strings"安企"and"CMS", you would write{{ "安企"|add:"CMS" }}The result is"安企CMS".

The key isaddThe filter expects a variable before the pipe as the left operand and an argument after the colon as the right operand each time it is called.

The challenge of chained calls

When you try{{ var1|add:var2|add:var3 }}In this form, the template engine will try to takevar1|add:var2the result as input and apply it againadd:var3. Although this is feasible in some complex filter chains,addThe filter usually only accepts a single independent parameter (obj2), rather than a list containing multiple independent variables.

Therefore, directly passing multipleaddThe filter goes through|Combine the symbols and expect it to be automatically recognizedvar3As the third variable to be added, it does not conformaddThe current design logic of the filter cannot directly convertvar3Identified as a new right operand, causing a syntax parsing error or an unexpected result.

Flexible implementation of multi-variable concatenation and summation

ThoughaddThe filter does not support direct|add:var2|add:var3Chaining syntax, but we have several very effective and clear methods to achieve the same purpose.

Plan one: step-by-step processing, usingsetLabel to define intermediate variables

The clearest and recommended approach is to usesetA label defines an intermediate variable. This helps us build the result step by step, making the template logic easier to understand and maintain.

Suppose we need to convertvar1/var2andvar3Three variables perform addition or concatenation:

{# 步骤1：计算 var1 和 var2 的结果 #}
{% set temp_result = var1|add:var2 %}

{# 步骤2：将 temp_result 与 var3 进行操作 #}
{{ temp_result|add:var3 }}

This method, although it adds one line of code, is clear in intent, very suitable for handling concatenation or summation of any number of variables, and avoids potential syntax confusion.

Plan two: nestedaddFilter

The AnQi CMS template engine supports complex expression parsing, which means you can include another filter or expression in the parameters of a filter. Therefore, we can use nestedaddA filter is used to perform multivariate operations:

{{ var1|add:(var2|add:var3) }}

In this example:

  1. First, the contents inside the parentheses will be calculated:var2|add:var3, resulting in a single value.
  2. Then,var1is used as the left operand, and the result from the first step is used as the right operand, and the operation is executed again.addfilter.

This method is more compact, and it can effectively reduce the number of lines of template code for a small number of variables. However, if there are too many variables, the nesting level may become complex, reducing readability.

Plan three: Consider using for string concatenationjoinFilter (if the data structure allows it)

If your goal is mainly to concatenate multiplestringVariables, and these variables can be organized into a list or array, thenjoinA filter will be a very powerful and efficient choice.

Assuming you have an array containing multiple strings (or one that can be dynamically generated), you can usejoina filter and specify a separator:

{% set my_strings = ['字符串A', '字符串B', '字符串C'] %}
{{ my_strings|join:' ' }} {# 结果："字符串A 字符串B 字符串C" #}

{% set my_data = [var1, var2, var3] %}
{{ my_data|join:'' }} {# 结果：所有变量无缝拼接 #}

This method is particularly efficient for concatenating a large number of strings, avoiding multiple callsaddThe cumbersome filter

Summary

Of Security CMSaddThe filter itself does not support{{ var1|add:var2|add:var3 }}This direct chaining syntax is designed to handle two operands. However, this does not mean that it is impossible to implement concatenation or summation of multiple variables. By usingsetCreate an intermediate variable, or by nestingaddFilter, we can all complete such operations flexibly and effectively. For string concatenation, if the variables can be organized into a list,joinThe filter provides a more elegant solution. Which option to choose depends on your specific needs and preference for code readability.

Frequently Asked Questions (FAQ)

1. Why AnQiCMS'saddDoes the filter not support direct chaining like other filters?

addThe filter is designed to handle the addition or concatenation of two operands (one left operand and a parameter after the pipe symbol). Unlike some general-purpose text processing filters that can accept any number of parameters or perform continuous pipeline operations on the results,addThe filter needs a main value and an added value explicitly each time it is executed. Therefore, it cannot correctly parse the third variable as its second parameter when called in a direct chaining manner.

2.addCan the filter mix and concatenate numbers and strings?

Yes.addThe filter has a certain type conversion ability. If you try to add a number to a string, it usually tries to convert the number to a string and then concatenate it. For example,{{ 5|add:"CMS" }}It will output."5CMS"In some complex scenarios, if the type conversion fails, it may ignore the parts that cannot be processed.

3. If I need to concatenate multiple string variables, besidesaddFilter, are there any more efficient or concise methods?

Yes, if your string variable can be organized into an array (or if you can build an array in the template), then usejoinThe filter is usually a more efficient and concise choice. You can put all the strings you want to concatenate into an array, and then use{{ my_array|join:'连接符' }}to concatenate them at once. For example,{% set parts = [var1, var2, var3] %}{{ parts|join:'-' }}.