https://github.com/anth12/diacritical-dotnet

Replace Diacritic characters with ASCII equivalents.
https://github.com/anth12/diacritical-dotnet

diacritics diacritics-removal dotnet dotnet-standard string-formatter

Last synced: about 2 months ago
JSON representation

Replace Diacritic characters with ASCII equivalents.

• Host: GitHub
• URL: https://github.com/anth12/diacritical-dotnet
• Owner: anth12
• License: mit
• Created: 2019-08-26T12:21:28.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2026-01-02T11:24:01.000Z (4 months ago)
• Last Synced: 2026-01-14T07:36:11.763Z (3 months ago)
• Topics: diacritics, diacritics-removal, dotnet, dotnet-standard, string-formatter
• Language: C#
• Homepage:
• Size: 250 KB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: ReadMe.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## Diacritical.Net

.NET Standard library to replace Diacritic characters with ASCII equivalents.

![Diacritical logo](https://raw.githubusercontent.com/anth12/diacritical-dotnet/master/assets/diacritical-small.png)

[![Build Status](https://img.shields.io/azure-devops/build/anthonyhalliday/Diacritical/1)](https://anthonyhalliday.visualstudio.com/Diacritical/_build/latest?definitionId=1&branchName=master)

[![Nuget](https://img.shields.io/nuget/v/Diacritical.Net)](https://www.nuget.org/packages/Diacritical.Net)

[![Downloads](https://img.shields.io/nuget/dt/Diacritical.Net)](https://www.nuget.org/packages/Diacritical.Net)

## Getting Started

Install the ([nuget][nuget]):

    PM> Install-Package Diacritical.Net

	> dotnet add package Diacritical.Net

Usage

```c#

"Buen día".RemoveDiacritics();      // Buen dia

"Witaj świecie".RemoveDiacritics(); // Witaj swiecie

"Olá Mundo".HasDiacritics();   // true

"Hello World".HasDiacritics(); // false

```

Sample mappings

- Á,Ă,Ắ,Ặ,Ằ,Ẳ,Ẵ,Ǎ,Â... -> **A**

- á,ă,ắ,ặ,ằ,ẳ,ẵ,ǎ,â... -> **a**

- Æ,Ǽ,Ǣ -> **AE**

- é,ĕ,ě,ȩ,ḝ,ê,ế,ệ,ề... -> **e**

- Ó,Ŏ,Ǒ,Ô,Ố,Ộ,Ồ,Ổ,Ỗ... -> **O**

- Ś,Ṥ,Š,Ṧ,Ş,Ŝ,Ș,Ṡ,Ṣ... -> **S**

- ...

A full list of supported mappings can be found [here][default provider].

Custom mappings can easily be added with a custom `IDiacriticProvider` implementation and registered with:

```c#

DiacriticMap.AddProvider(new MyCustomDiacriticProvider());

```

## Credits

- Logo eraser icon by Terrence Kevin Oleary (noun project)

- Diacritic mappings from [diacritics/database][diacritics database]

[nuget]: https://www.nuget.org/packages/Diacritical.Net/

[diacritics database]: https://github.com/diacritics/database

[default provider]: https://github.com/anth12/diacritical-dotnet/blob/master/Diacritical/DefaultDiacriticProvider.cs