dotnet add package Diacritics --version 3.3.20-pre
NuGet\Install-Package Diacritics -Version 3.3.20-pre
<PackageReference Include="Diacritics" Version="3.3.20-pre" />
paket add Diacritics --version 3.3.20-pre
#r "nuget: Diacritics, 3.3.20-pre"
// Install Diacritics as a Cake Addin #addin nuget:?package=Diacritics&version=3.3.20-pre&prerelease // Install Diacritics as a Cake Tool #tool nuget:?package=Diacritics&version=3.3.20-pre&prerelease
Diacritics are used across many languages in order to change the sound-values of the letters to which they are added. In software development, diacritics often have to be replaced with non-diacritics, e.g. to improve usability of user input. Diacritics.NET is a basic mapper between diacritic characters an non-diacritic characters.
Download and Install Diacritics
This library is available on NuGet: https://www.nuget.org/packages/Diacritics/ Use the following command to install Diacritics using NuGet package manager console:
PM> Install-Package Diacritics
You can use this library in any .Net project which is compatible to PCL (e.g. Xamarin Android, iOS, Windows Phone, Windows Store, Universal Apps, etc.)
Replace diacritic characters
The most common use case of this library is to find and replace diacritic characters in a given string.
RemoveDiacritics is a string extension method which returns a diacritics-free string.
// Arrange const string InputString = "Je veux aller à Saint-Étienne"; // Act string removeDiacritics = InputString.RemoveDiacritics(); // Assert removeDiacritics.Should().Be("Je veux aller a Saint-Etienne");
Find diacritic characters
The most common use case of this library is to detect and remove diacritic characters from a given string.
If you just want to check whether a string contains diacritics, use the string extensions method
// Arrange const string InputString = "Je veux aller à Saint-Étienne"; // Act bool hasDiacritics = InputString.HasDiacritics(); // Assert hasDiacritics.Should().BeTrue();
Using Diacritics with IoC
The example shown above uses extension methods which use a default implementation of
IDiacriticsMapper, namely type
DefaultDiacriticsMapper. If you're using an IoC container, you can register
IDiacriticsMapper either with the provided
DefaultDiacriticsMapper or with your own implementation of
Add custom diactrics mappings
Diacritics is extensible. You can write your own language accent by implementing
AccentMapping base class).
DiacriticsMapper accepts any
IAccentMapping type at construction time.
You are highly welcome to contribute to this library. Just create a fork, commit your changes and create a pull request.
TODO: Add/Remove methods for adding/removing accents at runtime.
Tested Version<br> https://www.nuget.org/packages/Diacritics/2.1.19291.8-pre
Benchmark Environment<br> BenchmarkDotNet=v0.11.5, OS=Windows 10.0.17134.885 (1803/April2018Update/Redstone4) Intel Core i7-7600U CPU 2.80GHz (Kaby Lake), 1 CPU, 4 logical and 2 physical cores Frequency=2835933 Hz, Resolution=352.6176 ns, Timer=TSC .NET Core SDK=3.0.100 [Host] : .NET Core 2.2.4 (CoreCLR 4.6.27521.02, CoreFX 4.6.27521.01), 64bit RyuJIT ShortRun : .NET Core 2.2.4 (CoreCLR 4.6.27521.02, CoreFX 4.6.27521.01), 64bit RyuJIT
Job=ShortRun IterationCount=3 LaunchCount=1 WarmupCount=3
|RemoveDiacritics (9 latin chars)||230.5 ns||476.2 ns||26.10 ns|
|RemoveDiacritics (23 diacritic chars)||651.5 ns||843.4 ns||46.23 ns|
|RemoveDiacritics (408 latin chars)||8,697.1 ns||9,938.1 ns||544.74 ns|
|RemoveDiacritics (729 diacritic chars)||15,045.0 ns||12,893.0 ns||706.71 ns|
Legend<br> Mean : Arithmetic mean of all measurements<br> Error : Half of 99.9% confidence interval<br> StdDev : Standard deviation of all measurements<br> Rank : Relative position of current benchmark mean among all benchmarks (Arabic style)<br> 1 ns : 1 Nanosecond (0.000000001 sec)<br>
This project is Copyright © 2019 Thomas Galliker. Free for non-commercial use. For commercial use please contact the author.
|Product||Versions Compatible and additional computed target framework versions.|
|.NET||net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.|
|.NET Core||netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.|
|.NET Standard||netstandard1.2 is compatible. netstandard1.3 was computed. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 is compatible.|
|.NET Framework||net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.|
|MonoAndroid||monoandroid was computed.|
|MonoMac||monomac was computed.|
|MonoTouch||monotouch was computed.|
|Tizen||tizen30 was computed. tizen40 was computed. tizen60 was computed.|
|Universal Windows Platform||uap was computed. uap10.0 was computed.|
|Windows Phone||wpa81 was computed.|
|Windows Store||netcore451 was computed.|
|Xamarin.iOS||xamarinios was computed.|
|Xamarin.Mac||xamarinmac was computed.|
|Xamarin.TVOS||xamarintvos was computed.|
|Xamarin.WatchOS||xamarinwatchos was computed.|
- No dependencies.
- NETStandard.Library (>= 1.6.1)
- No dependencies.
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Diacritics:
Extension method to convert any string into a dash seperated string to be used for a URL. Eg: hello world is turned into hello-world. Non alpha numeric characters are stripped and diacritics are removed too.
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on Diacritics:
The Free Software Media System
Open source media server.
- New portuguese accents (masculine or
- Continuous improvement, new diacritics mappings
- Bug fixes and performance improvements
- Performance improvements in RemoveDiacritics
- New method StaticDiacritics.SetDefaultMapper to replace the default IDiacriticsMapper
- Add vietnamese mappings
- Refactoring to NetStandard + NET 4.5.2
- Several bug fixes + new diacritics added
- Add Turkish ı mapping to i
- Support for .Net Standard 1.0
- Add Icelandic ð mapping to o
- Add Spanish ñ mapping to n
- Add support for combined cedilla characters
- Fix German ß mapping to ss
- Add .Net 4.5 implementation as dedicated assembly
- Add missing accents mappings
- Bug fix: Russian accents mapping fixed
- Bug fix: RemoveDiacritics now also removes upper case diacritic characters
- Bug fix: Correct handling of first letter upper case characters
- Improved initialization performance by factor 8
- Added ArabicAccentsMapping
- Added BulgarianAccentsMapping
- Added CatalanAccentsMapping
- Added CroatianAccentsMapping
- Added CzechAccentsMapping
- Added DutchAccentsMapping
- Added EnglishAccentsMapping
- Added EstonianAccentsMapping
- Added FilipinoAccentsMapping
- Added FrenchAccentsMapping
- Added GermanAccentsMapping
- Added GreekAccentsMapping
- Added HungarianAccentsMapping
- Added IcelandicAccentsMapping
- Added ItalianAccentsMapping
- Added LatvianAccentsMapping
- Added PolishAccentsMapping
- Added PortugueseAccentsMapping
- Added RomanianAccentsMapping
- Added RussianAccentsMapping
- Added SlovakianAccentsMapping
- Added SpanishAccentsMapping
- Added TurkishAccentsMapping
- Added UkarainianAccentsMapping