How does AnQi CMS template handle floating-point arithmetic with decimal points?

As an experienced website operations expert, I am fully aware of the importance of data processing and precise calculations in website display and business logic during my daily work.AnQiCMS (AnQiCMS) provides great convenience for content operators with its efficient and flexible features.Today, let's talk about a practical problem that often arises in template development - how to elegantly handle floating-point arithmetic with decimal points in Anqi CMS templates.

The template engine of Anqi CMS adopts syntax similar to Django, which allows operators familiar with web development to quickly get started.Its strength lies in its ability to easily display data and also perform certain data processing at the template level, including the floating-point arithmetic we are discussing today.Understand and master these skills, it will help us build dynamic pages more flexibly, such as calculating product prices, displaying discounts, or even presenting simple statistics.

Core Function: Direct Arithmetic Operation

Performing floating-point arithmetic in AnQi CMS templates is far less complex than you might imagine. Its template engine allows us to directly use double curly braces{{ }}In Chinese, common mathematical operators are used, which is as natural as writing a simple equation.Whether it is addition, subtraction, multiplication, division, or more advanced power operations and modulo operations, AnQiCMS can recognize and calculate them directly.

For example, suppose you have a product priceitem.Priceis a floating-point number (such as99.99), the number of items purchased by the useritem.Quantityis an integer (such as2），You want to calculate the total price and display it, then you can simply implement it like this:

{{ item.Price * item.Quantity }}

If you need to add shipping costsshippingFee(For example10.50)，and calculate a discount (for example0.8），the entire expression can be written together:

商品总价：{{ (item.Price * item.Quantity + shippingFee) * 0.8 }} 元

Hereitem.PriceandshippingFeeIf it is a floating-point number type itself, the template engine will automatically perform floating-point arithmetic. In addition, you can also use comparison operators (==,!=,<,>,<=,>=) to compare floating-point numbers for conditional judgment. For example, check if the total amount exceeds a certain threshold:

{% if (item.Price * item.Quantity) > 100 %}
    <p>恭喜，订单金额已超过100元！</p>
{% endif %}

Ensure the data type is correct: Type conversion filter

In actual template development, the data we get from the backend may not always be the type we expect.For example, the price field stored in the database may be read as a string, or the numerical value submitted by the user through a form may also be a string type.In this case, performing direct mathematical operations may lead to unexpected results, even errors.

To ensure the accuracy of the calculation, AnQiCMS templates providefloatandintegera filter to force variables to convert to floating-point numbers or integer types.

• floatFilter:When you are sure a variable represents a floating-point number but its current type is a string or another incompatible type, usefloata filter to convert it to a floating-point number.

  {% set priceString = "99.99" %}
  {% set quantityString = "2" %}
  总金额：{{ priceString|float * quantityString|float }}
  

  So, even ifpriceStringandquantityStringIt starts as a string, it is also correctly converted to a floating-point number for multiplication. If the conversion fails,floatthe filter will return0.0.

• integerFilter:Similarly, if you need to convert a variable to an integer for computation (for example, product inventory is usually an integer), you can useintegerfilter.

  {% set stockString = "10.5" %} {# 假设某个字段被误存为浮点数形式的字符串 #}
  当前库存：{{ stockString|integer }}
  

  HerestockStringwill be converted to an integer10. If the conversion fails,integerthe filter will return0.

By reasonably utilizing these type conversion filters, it can greatly enhance the robustness of template code, avoiding calculation errors due to mismatched data types.

Improve and precise control: floating-point number formatting display

After performing floating-point arithmetic, we usually need to present the result in a user-friendly manner, such as currency formatting, which usually requires retaining two decimal places.The AnQiCMS template provides various filters to help us finely control the display format of floating-point numbers.

• floatformatFilter:This is the most commonly used floating-point number formatting tool, which can retain the specified decimal places of the floating-point number.

  • If no parameter is specified, it will default to retaining one decimal place and will automatically handle trailing zeros (if the decimal part is.0It will display as an integer. It will also round off to the third decimal place.

    
    {{ 34.23234|floatformat }} {# 显示 34.2 #}
    {{ 34.00000|floatformat }} {# 显示 34 #}
    {{ 34.26000|floatformat }} {# 显示 34.3 #}
    

  • If you want to keep more or fewer decimal places, you can pass a number as a parameter. For example, to keep three decimal places:

    
    {{ 34.23234|floatformat:3 }} {# 显示 34.232 #}
    {{ 34.00000|floatformat:3 }} {# 显示 34.000 #}
    

    floatformatThe filter is very useful in scenarios where it is necessary to display fixed decimal places for currencies and other such situations.

• stringformatFilter:For more complex formatting needs, such as adding a currency symbol before a number or displaying in a specific alignment,stringformatThe filter provides powerfulfmt.Sprintf()formatting capabilities of style.

  {% set totalPrice = 123.456 %}
  最终价格：{{ totalPrice|stringformat:"¥%.2f" }} {# 显示 ¥123.46 #}
  百分比：{{ 0.55555|stringformat:"%.2f%%" }} {# 显示 55.56% #}
  

  stringformatProvided with extremely high flexibility, it can meet the formatting needs of almost all numbers to strings, especially when you need to combine special symbols with numbers.

Through combiningfloatformatandstringformatYou can ensure that the result of floating-point arithmetic is not only accurate but also presented in a way that best conforms to user habits and business needs on the page.

Examples of actual application scenarios

In the actual operation of Anqi CMS, floating-point arithmetic is everywhere:

1. Product price and order total:Calculate the product price multiplied by the quantity, then subtract the coupon discount, add the shipping fee, and get the final payment amount.

   {% set itemPrice = 50.75 %}
   {% set quantity = 3 %}
   {% set discount = 0.9 %} {# 9折 #}
   {% set shippingFee = 8.00 %}
   {% set finalAmount = (itemPrice * quantity * discount + shippingFee)|floatformat:2 %}
   <p>商品单价：{{ itemPrice }} 元</p>
   <p>购买数量：{{ quantity }} 件</p>
   <p>折扣：{{ (1 - discount)*100 }}%</p>
   <p>运费：{{ shippingFee }} 元</p>
   <p>最终支付：{{ finalAmount }} 元</p>
   

2. Percentage display:Calculate product discounts, taxes, sales growth rates, and other percentage data.

   {% set salesThisMonth = 15000.00 %}
   {% set salesLastMonth = 12000.00 %}
   {% set growthRate = (salesThisMonth - salesLastMonth) / salesLastMonth * 100 %}
   <p>本月销售额：{{ salesThisMonth }} 元</p>
   <p>上月销售额：{{ salesLastMonth }} 元</p>
   <p>增长率：{{ growthRate|floatformat:2 }}%</p>
   

3. Display statistical data:Calculate average values, ranking scores, and so on.

   {% set totalScore = 85.5 + 92.0 + 78.5 %}
   {% set numberOfStudents = 3 %}
   {% set averageScore = totalScore / numberOfStudents %}
   <p>总分：{{ totalScore }}</p>
   <p>平均分：{{ averageScore|floatformat:1 }}</p>
   

These examples demonstrate how to perform basic floating-point arithmetic in the Anqi CMS template and use filters to format it to meet diverse content display needs.

Summary