NormalizationForm Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Defines the type of normalization to perform.
public enum class NormalizationFormpublic enum NormalizationForm[System.Runtime.InteropServices.ComVisible(true)]
public enum NormalizationFormtype NormalizationForm = [<System.Runtime.InteropServices.ComVisible(true)>]
type NormalizationForm = Public Enum NormalizationForm- Inheritance
- Attributes
Fields
| Name | Value | Description |
|---|---|---|
| FormC | 1 | Indicates that a Unicode string is normalized using full canonical decomposition, followed by the replacement of sequences with their primary composites, if possible. |
| FormD | 2 | Indicates that a Unicode string is normalized using full canonical decomposition. |
| FormKC | 5 | Indicates that a Unicode string is normalized using full compatibility decomposition, followed by the replacement of sequences with their primary composites, if possible. |
| FormKD | 6 | Indicates that a Unicode string is normalized using full compatibility decomposition. |
Remarks
Some Unicode sequences are considered equivalent because they represent the same character. For example, the following are considered equivalent because any of these can be used to represent "ắ":
"\u1EAF" (U+1EAF LATIN SMALL LETTER A WITH BREVE AND ACUTE)
"\u0103\u0301" (U+0103 LATIN SMALL LETTER A WITH BREVE + U+0301 COMBINING ACUTE ACCENT)
"\u0061\u0306\u0301" (U+0061 LATIN SMALL LETTER A + U+0306 COMBINING BREVE + U+0301 COMBINING ACUTE ACCENT)
However, ordinal, that is, binary, comparisons consider these sequences different because they contain different Unicode code values. Before performing ordinal comparisons, applications must normalize these strings to decompose them into their basic components.
Each composite Unicode character is mapped to a more basic sequence of one or more characters. The process of decomposition replaces composite characters in a string with their more basic mappings. A full decomposition recursively performs this replacement until none of the characters in the string can be decomposed further.
Unicode defines two types of decompositions: compatibility decomposition and canonical decomposition. In compatibility decomposition, formatting information might be lost. In canonical decomposition, which is a subset of compatibility decomposition, formatting information is preserved.
Two sets of characters are considered to have canonical equivalence if their full canonical decompositions are identical. Likewise, two sets of characters are considered to have compatibility equivalence if their full compatibility decompositions are identical.
For more information about normalization, decompositions and equivalence, see Unicode Standard Annex #15: Unicode Normalization Forms at unicode.org.
