How do the `trim`, `trimLeft`, `trimRight` filters remove whitespace or specific characters from the beginning or end of a string?

In website operation and content management, we often encounter the need for string processing, especially in data entry, content display, or API interaction.For example, a user may have mistakenly entered multiple spaces before or after a text box, or some data may have been accompanied by extraneous specific characters.These seemingly minor issues may affect the layout and aesthetics of the content, and even lead to functional anomalies.

The template engine of Anqi CMS provides a series of powerful filters to help us easily handle these string cleaning tasks. Today, let's take a detailed look at three very practical filters:trim/trimLeftandtrimRightHow do they help us remove whitespace or specified characters from the beginning and end or one side of a string.

trimFilter: Bidirectional cleaning, keeping the string clean and tidy at both ends

Imagine that you have obtained some text content from somewhere, or the user has entered some text in a form, and you find that there are unnecessary spaces at both ends of the text, even some special characters. At this time,trimThe filter comes into play. Its main function isRemove all whitespace characters from both ends of the string.

When used without any parameterstrimWhen filtering, it will default clear the leading and trailing of the stringAll Unicode whitespace charactersIncluding spaces, tabs, newlines, and so on.

For example, there is a text with leading and trailing spaces:

{{ " 欢迎使用安企CMS " | trim }}

Aftertrimprocessing, the output will be:

欢迎使用安企CMS

Buttrimits functionality is not limited to this. It can also delete the one you specify[en]Specific character[en]If you providetrima string as a parameter after this, it will take any character contained inany characterRemove from the beginning and end of the original string until a character not in the parameter string is encountered.

For example, we want to remove the string“欢迎使用安企CMS”The "Welcome" and "CMS" words at both ends (note that here we remove the string parameters that contain theanycharacter):

{{ "欢迎使用安企CMS" | trim:"欢迎CMS" }}

The parameter here is"欢迎CMS"It includes characters such as 'huan', 'ying', 'C', 'M', 'S'.trimIt will start from both ends of the string and remove all these characters until it encounters '使' or '企'. Therefore, the output will be:

使用安企

We can also assign the processed result to a variable for future use:

{% set original_string = " 欢迎使用安企CMS（AnQiCMS） " %}
{% set cleaned_string = original_string | trim %}
<div>清理空白字符后的结果：{{ cleaned_string }}</div>

{% set original_string_2 = "###重要通知### 这是一个重要消息 ###" %}
{% set cleaned_string_2 = original_string_2 | trim:"#" %}
<div>清理特定字符后的结果：{{ cleaned_string_2 }}</div>

trimLeftFilter: Focus on the left, preserving the original appearance on the right

Sometimes, you might want to clean the content on the left side (or the beginning) of a string while keeping the right side (the end) unchanged.For example, your data format requires that there be no spaces on the left, but data markers may be retained on the right.trimLeftThe filter comes into play.

WithtrimSimilarly, without parameters:trimLeftIt will remove all leading Unicode whitespace characters from the string:

{{ " 欢迎使用安企CMS " | trimLeft }}

The output will be:

欢迎使用安企CMS 

Notice that the spaces on the right side of the string are still preserved.

If parameters are provided,trimLeftthe parameters containing in the string will be deleted,any characterbut only limited to the left side of the string:

{{ "欢迎使用安企CMS" | trimLeft:"欢迎" }}

The output will be:

使用安企CMS

Here are the"欢迎"parameters include '欢' and '迎'.trimLeftWill remove '欢' and '迎' from the left until '使' is encountered.

trimRightFilter: Focus on the right, the left is unaffected.

WithtrimLeftRelative, if you only need to clean the content on the right side (tail) of the string, thentrimRightthe filter is your ideal choice.

without parameterstrimRightWill remove all Unicode whitespace characters from the right side of the string:

{{ " 欢迎使用安企CMS " | trimRight }}

The output will be:

 欢迎使用安企CMS

Similarly, spaces on the left side of the string are preserved.

If parameters are provided,trimRightthe parameters containing in the string will be deleted,any characterBut limited to the right side of the string only:

{{ "欢迎使用安企CMS" | trimRight:"CMS" }}

The output will be:

欢迎使用安企

Here are the"CMS"The parameter includes 'C', 'M', 'S'.trimRightThese characters will be removed from the right until '企' is encountered.

Summary and application scenarios

These three filters are the tools for string cleaning in the AnQi CMS template:

• trimWhen you need to ensure that there is no redundant content at either end of a string (whether it is whitespace characters or specific characters), use it.
• trimLeft: Use this when you only want to normalize the beginning of a string and not the end.
• trimRight: Use this when you only want to normalize the end of a string and not the beginning.

Understand how they default to handling whitespace characters when no parameters are provided, and how they remove the parameter string when parameters are providedanyThe logic of characters, which can help you control the output of content more accurately.These filters can make your content management more efficient and flexible, whether it's for cleaning user-submitted data, standardizing external interface content, or simply beautifying the page display.

---

Common Questions (FAQ)

Q1:trimWhat is the difference between a filter with no parameters and one with parameters?

A1:The main difference lies in the objects cleared:

• When no parameters are provided:(For example:){{ value | trim }}), it will remove all Unicode whitespace characters from both ends of the string)Unicode whitespace charactersIncluding ordinary spaces, tabs, and newline characters, etc.
• When parameters are included(For example:){{ value | trim:"abc" }}), it will remove the parameters contained in the parameter string.any characterIt removes characters from both ends of the original string. For example,"banana" | trim:"an"It will remove all 'a' and 'n', the result might be"b". It is not removing the entire substring"an", but removing any character in the set{'a', 'n'}.

Q2: How do I remove all spaces from a string, not just the leading and trailing ones?

A2: trimSeries filters only process the beginning and end of strings. If you want to remove all spaces (or specific characters) inside a string, you should usereplaceFilter. For example, to remove all spaces, you can write: {{ "你好 世界" | replace:" , " }}The first parameter is the character you want to replace, and the second parameter is the character to replace it with (an empty string here).

Q3: Do these filters support Chinese characters?

A3:Yes, the template engine of Anqi CMS has good support for Unicode characters (including Chinese characters). Whether it is whitespace characters (such as full-width spaces) or the specific Chinese characters you specify,trim/trimLeftandtrimRightThe filter can correctly identify and process.