community.general.unicode_normalize filter – Normalizes unicode strings to facilitate comparison of characters with normalized forms
Note
This filter plugin is part of the community.general collection (version 6.6.9).
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.unicode_normalize
.
New in community.general 3.7.0
Synopsis
Normalizes unicode strings to facilitate comparison of characters with normalized forms.
Input
This describes the input of the filter, the value before | community.general.unicode_normalize
.
Parameter |
Comments |
---|---|
A unicode string. |
Positional parameters
This describes positional parameters of the filter. These are the values positional1
, positional2
and so on in the following
example: input | community.general.unicode_normalize(positional1, positional2, ...)
Parameter |
Comments |
---|---|
The normal form to use. See https://docs.python.org/3/library/unicodedata.html#unicodedata.normalize for details. Choices:
|
Examples
- name: Normalize unicode string
ansible.builtin.set_fact:
dictionary: "{{ 'ä' | community.general.unicode_normalize('NFKD') }}"
# The resulting string has length 2: one letter is 'a', the other
# the diacritic combiner.
Return Value
Key |
Description |
---|---|
The normalized unicode string of the specified normal form. Returned: success |