In the template development of AnQi CMS, we often need to handle various types of data, among which the conversion between numeric strings and floating-point numbers is a common and important requirement.For example, you may get a price (such as "12.50") or a numeric product inventory (such as "100") from the backend custom fields. When you need to perform mathematical operations, compare sizes, or display the data in a specific format in the template, it is particularly important to convert the data from a string type to a floating-point number accurately.

The template engine of Anqi CMS provides flexible and powerful Filters function, which can help us easily achieve this type of conversion.Below, let's take a detailed look at how to convert a numeric string to a floating-point number in a template, and discuss the techniques for its practical application.

UnderstandingfloatFilter: Accurately convert to floating-point number

When you need to convert a string representing a number to a floating-point number, you can usefloata filter. This filter will parse the input string into a floating-point number.

Basic syntax:

{{ 你的变量 | float }}

Principle of Operation and Example:

Suppose you have a custom field namedproductPrice, its value is a string, for example"99.99".

  1. Example of successful conversion:

    {% set priceString = "99.99" %}
{% set priceFloat = priceString | float %}
<p>原字符串价格：{{ priceString }}</p>
<p>转换后的浮点数价格：{{ priceFloat }}</p>

    The output will be:

    原字符串价格：99.99
转换后的浮点数价格：99.990000

    As you can see,"99.99"Successfully converted to a floating-point number99.990000。By default, floating-point numbers will display more precision.

  2. Handle non-numeric strings:IffloatThe filter receives a string that cannot be parsed as a number (for example)"这不是数字"or"foobar"), it will return by default.0.0.

    {% set invalidString = "foobar" %}
{% set convertedFloat = invalidString | float %}
<p>非数字字符串转换结果：{{ convertedFloat }}</p>

    The output will be:

    非数字字符串转换结果：0.000000

    Understanding this is very important, as it can help you debug or set default values when handling potential dirty data.

辅助功能：integerFilter (converted to integer)

Although the topic is floating-point number conversion, in some cases, you may also need to convert number strings to integers. The Anqi CMS template also providesintegerFilter.

Basic syntax:

{{ 你的变量 | integer }}

Principle of Operation and Example:

  1. Example of successful conversion:

    {% set countString = "123" %}
{% set countInteger = countString | integer %}
<p>原字符串计数：{{ countString }}</p>
<p>转换后的整数计数：{{ countInteger }}</p>

    The output will be:

    原字符串计数：123
转换后的整数计数：123

  2. Process floating-point string or non-numeric string: integerThe filter truncates the decimal part directly during conversion (instead of rounding off), and returns if it encounters a string that cannot be parsed0.

    {% set floatAsString = "5.8" %}
{% set convertedInteger = floatAsString | integer %}
<p>浮点数字符串转换为整数：{{ convertedInteger }}</p>


{% set invalidString = "hello" %}
{% set zeroInteger = invalidString | integer %}
<p>非数字字符串转换为整数：{{ zeroInteger }}</p>

    The output will be:

    浮点数字符串转换为整数：5
非数字字符串转换为整数：0

  3. Use filters in series:You can also usefloatandintegerUsing filters in series is very useful when it is necessary to ensure that the data is of numeric type before performing integer processing.

    {% set complexString = "10.7" %}
{% set result = complexString | float | integer %} {# 先转浮点，再转整数 #}
<p>串联转换结果：{{ result }}</p>

    The output will be:

    串联转换结果：10

Application scenarios and precautions

  1. Performing numeric calculations:When you get the value from a custom field (such asarchive.Price), the value is a string type, it will be processed directly.+or-The operation may result in string concatenation instead of mathematical addition and subtraction.Convert to a floating-point number or integer to perform correct mathematical operations.addFilter:

    {% set basePrice = archive.Price | float %} {# 假设 archive.Price 是 "100.50" #}
{% set shippingCost = 10.0 %}
{% set totalPrice = basePrice | add:shippingCost %}
<p>商品总价：{{ totalPrice }}</p> {# 输出 110.500000 #}

  2. Number comparison:When making conditional judgments (such as{% if priceFloat > 100.0 %}When, ensure that the variable is of numeric type is crucial, otherwise, the string comparison rules may lead to unexpected results.

    {% set currentPrice = archive.Price | float %} {# 假设 archive.Price 是 "99.99" #}
{% if currentPrice > 100.00 %}
    <p>价格高于100元</p>
{% else %}
    <p>价格不高于100元</p>
{% endif %}

  3. Formatted output:After converting to a floating-point number, you can further usefloatformatorstringformatFilter to control the number of decimal places or output format to make it more in line with display requirements.

    {% set price = archive.Price | float %} {# 假设 archive.Price 是 "123.456" #}
<p>保留两位小数：{{ price | floatformat:2 }}</p> {# 输出 123.46 #}
<p>按货币格式输出：{{ price | stringformat:"¥%.2f" }}</p> {# 输出 ¥123.46 #}

Summary

In the Anq CMS template,floatandintegerFilter is a powerful tool for processing numeric strings.They can ensure the accuracy of data types, thus achieving reliable numerical computation, comparison, and formatted display.During the development process, be sure to flexibly apply these filters according to your business logic and data source characteristics to build a website page with comprehensive functions and accurate data.

Common Questions (FAQ)

Q1: Why does the number field I get from the background become a string concatenation when I perform addition and subtraction directly?A1: The template engine of AnQi CMS may treat the data read from the database or custom fields as string type by default, even if you input pure numbers in the background. When you perform an operation on two string type data+When performing operations, the template engine will "concatenate" strings according to string rules rather than "mathematical addition". Therefore, be sure to convert these values to numerical data before using them in mathematical calculations.|floator|integerFilter converts it explicitly to a numeric type.

Q2: If my numeric string is empty (e.g."") or contains non-numeric characters,floathow will the filter handle it?A2: IffloatThe filter receives an empty string or a string that cannot be parsed as a valid number (for example"abc"), and it will default to converting it to0.000000. Similarly,integerThe filter will return0This means you don't have to worry about template errors, but you need to consider it in the business logic.0Whether it is the default value you expect, or whether additional conditional judgments are needed to handle this situation.

Q3: How do I control the number of decimal places after converting to a floating-point number, such as displaying only two decimal places?A3: After converting a numeric string to a floating-point number, you can use other filters to further format the output. For example,floatformat:2The filter can help you round off floating-point numbers to two decimal places:{{ archive.Price | float | floatformat:2 }}. Alternatively, you can also usestringformatfilter for more complex formatting,{{ archive.Price | float | stringformat:"%.2f" }}.