Text.ConvertUnicodeToCharacterDecomposition
-------------------------------------------

Converts text by applying unicode character normalization.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Text](component_Text.md) | [5.2](newinversion52.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "Text.ConvertUnicodeToCharacterDecomposition"; Text ) 

**MBS**( **"Text.ConvertUnicodeToCharacterDecomposition";** /\* Converts text by applying unicode character normalization. \*/  
**$Text**) /\* The text to process.e.g. "Hello" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Text | The text to process. | "Hello" |

### Result

Returns text or error.

### Description

Converts text by applying unicode character normalization.  
This function replaces character represented by one unicode character by the decomposed variant.  
  
see also   
[https://en.wikipedia.org/wiki/Unicode\_equivalence](https://en.wikipedia.org/wiki/Unicode_equivalence)  
  
Rewritten for version 12.1 to preserve text styles and be quicker.  
### Examples

Test function with ä:

 MBS ("[Text.Characters](TextCharacters.md)"; MBS ( "[Text.ConvertUnicodeToCharacterComposition](TextConvertUnicodeToCharacterComposition.md)"; Char(97) &amp; Char(776) ))  
<small>  
Example result: 228</small>Test with ä as 228:

 MBS ("[Text.Characters](TextCharacters.md)"; MBS ( "Text.ConvertUnicodeToCharacterDecomposition"; Char(228) ))  
<small>  
Example result: 97 776</small>Test functions:

 Let(\[  
i = "tränenüberströmt";  
r = MBS ( "Text.ConvertUnicodeToCharacterDeComposition"; i);  
t = MBS ( "[Text.Characters](TextCharacters.md)"; r);  
x = MBS ( "[Text.ConvertUnicodeToCharacterComposition](TextConvertUnicodeToCharacterComposition.md)"; r);  
tr= MBS ( "[Text.Characters](TextCharacters.md)"; x)  
  
\];  
r &amp; ¶ &amp; t &amp;¶&amp; x &amp; ¶ &amp;   
"before " &amp; MBS ("[Text.Length](TextLength.md)"; i) &amp; ", middle " &amp; MBS ("[Text.Length](TextLength.md)"; r) &amp; ", after " &amp; MBS ("[Text.Length](TextLength.md)"; x) &amp; ¶ &amp; tr)  
<small>  
Example result:   
tränenüberströmt  
116 114 97 776 110 101 110 117 776 98 101 114 115 116 114 111 776 109 116  
tränenüberströmt  
before 16, middle 19, after 16  
116 114 228 110 101 110 252 98 101 114 115 116 114 246 109 116</small>Mount with properly encoding french accent:

 Set Variable \[ $path ; Value: MBS ( "[Files.Mount](FilesMount.md)"; "afp://stockage.madabout.lu/" &amp; MBS ( "[Text.EncodeURLComponent](TextEncodeURLComponent.md)"; MBS ( "Text.ConvertUnicodeToCharacterDecomposition"; "Travail archivé" )); "UTF-8" )) \]  
  
\# URL is "afp://test.myserver.local/Travail%20archiv%8E"   
### See also

- [Files.Mount](FilesMount.md)
- [Text.Character](TextCharacter.md)
- [Text.Characters](TextCharacters.md)
- [Text.ConvertUnicodeToCharacterComposition](TextConvertUnicodeToCharacterComposition.md)
- [Text.EncodeURLComponent](TextEncodeURLComponent.md)
- [Text.Length](TextLength.md)

### Release notes

- **Version 12.1**
    - Rewrote [Text.RemoveControlCharacters](https://www.mbsplugins.eu/TextRemoveControlCharacters.shtml), [Text.ConvertUnicodeToCharacterDecomposition](https://www.mbsplugins.eu/TextConvertUnicodeToCharacterDecomposition.shtml) and [Text.ConvertUnicodeToCharacterComposition](https://www.mbsplugins.eu/TextConvertUnicodeToCharacterComposition.shtml) functions to preserve text styles.

### Example Databases

- [Text functions/Unicode Compositions](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Text%20functions/Unicode%20Compositions.shtml#1293FieldAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 12.1pr2](https://www.mbsplugins.de/archive/2022-02-08/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 3th August 2015 , last changed 4th March 2022

  
[Text.ConvertUnicodeToCharacterComposition](TextConvertUnicodeToCharacterComposition.md) - [Text.CountWords](TextCountWords.md)

[HTML Version](TextConvertUnicodeToCharacterDecomposition.shtml)