Diacritics 3.3.29

There is a newer prerelease version of this package available.
See the version list below for details.

dotnet add package Diacritics --version 3.3.29

NuGet\Install-Package Diacritics -Version 3.3.29

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Diacritics" Version="3.3.29" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Diacritics --version 3.3.29

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Diacritics, 3.3.29"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install Diacritics as a Cake Addin
#addin nuget:?package=Diacritics&version=3.3.29

// Install Diacritics as a Cake Tool
#tool nuget:?package=Diacritics&version=3.3.29

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Diacritics.NET

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.)

API Usage

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 HasDiacritics.

// 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 IDiacriticsMapper.

Add custom diactrics mappings

Diacritics is extensible. You can write your own language accent by implementing IAccentMapping (or 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.

Benchmark Tests

Tested Version https://www.nuget.org/packages/Diacritics/2.1.19291.8-pre

Benchmark Environment 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

Benchmark Results

Method	Mean	Error	StdDev
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 Mean : Arithmetic mean of all measurements Error : Half of 99.9% confidence interval StdDev : Standard deviation of all measurements Rank : Relative position of current benchmark mean among all benchmarks (Arabic style) 1 ns : 1 Nanosecond (0.000000001 sec)

License

Product	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-browser 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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 4.5
- No dependencies.
.NETStandard 1.2
- NETStandard.Library (>= 1.6.1)
.NETStandard 2.0
- No dependencies.
.NETStandard 2.1
- No dependencies.

NuGet packages (9)

Showing the top 5 NuGet packages that depend on Diacritics:

Package	Downloads
Jellyfin.Extensions Package Description	64.3K
Dialogs Chatbot dll	42.3K
SunamoFileSystem Overall working with filesystem	9.0K
SunamoCollections Working with non-generic collections	8.2K
SunamoDevCode Another code mainly for working with C# in all ways. Will be in future merged with SunamoCode and SunamoCSharp.	6.8K

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Diacritics:

Repository	Stars
jellyfin/jellyfin The Free Software Media System	35.4K
vesoapp/veso Open source media server.	145

Version	Downloads	Last updated
3.3.31-pre	95	10/6/2024
3.3.29	185,379	4/25/2024
3.3.28-pre	1,793	3/11/2024
3.3.27	80,533	1/14/2024
3.3.26-pre	347	1/14/2024
3.3.20-pre	6,183	5/27/2023
3.3.19-pre	660	4/18/2023
3.3.18	203,145	3/19/2023
3.3.17-pre	877	12/31/2022
3.3.16-pre	673	12/21/2022
3.3.15-pre	673	12/18/2022
3.3.14	324,451	4/27/2022
3.3.13-pre	715	4/17/2022
3.3.12-pre	706	4/17/2022
3.3.11-pre	14,418	1/9/2022
3.3.10	312,466	11/11/2021
3.3.9-pre	768	11/11/2021
3.3.8-pre	739	11/11/2021
3.3.7-pre	732	11/11/2021
3.3.6-pre	758	11/11/2021
3.3.4	37,223	10/7/2021
3.3.3-pre	754	10/7/2021
3.2.21207.2-pre	868	7/26/2021
3.1.20334.1-pre	6,884	11/29/2020
3.1.20333.3-pre	913	11/28/2020
3.0.20116.1-pre	3,627	4/25/2020
2.1.20116.2-pre	939	4/25/2020
2.1.20036.1	378,124	2/4/2020
2.1.20017.2-pre	957	1/17/2020
2.1.19293.1	64,346	10/20/2019
2.1.19292.2-pre	1,023	10/19/2019
2.1.19292.1-pre	991	10/19/2019
2.1.19291.8-pre	1,037	10/18/2019
2.1.19291.6-pre	1,014	10/18/2019
2.1.19286.1-pre	1,014	10/13/2019
2.1.19240.1-pre	1,053	8/28/2019
2.0.19240.3	28,270	8/28/2019
2.0.19240.2-pre	1,103	8/28/2019
2.0.19117.1-pre	1,293	4/27/2019
2.0.18316.1	95,174	11/12/2018
2.0.18311.1	1,529	11/7/2018
2.0.18308.2-pre	1,261	11/4/2018
2.0.18308.1-pre	1,284	11/4/2018
2.0.18282.1	6,490	10/9/2018
2.0.18281.2-pre	1,313	10/8/2018
2.0.18281.1-pre	1,323	10/8/2018
1.0.8-pre1	1,419	9/5/2018
1.0.7	71,662	6/13/2018
1.0.7-pre2	1,428	6/11/2018
1.0.7-pre1	1,404	6/11/2018
1.0.6	7,745	2/21/2018
1.0.5	3,374	6/8/2017
1.0.5-pre3	1,478	4/7/2017
1.0.5-pre2	1,464	4/7/2017
1.0.5-pre1	1,440	4/7/2017
1.0.4	11,610	3/24/2017
1.0.4-pre2	1,513	3/22/2017
1.0.4-pre1	1,609	12/13/2016
1.0.3	3,441	12/13/2016
1.0.3-pre3	1,551	12/13/2016
1.0.3-pre2	1,539	4/4/2016
1.0.3-pre1	1,552	4/4/2016
1.0.2	19,720	1/28/2016
1.0.1	1,736	12/16/2015
1.0.0	1,928	12/16/2015
1.0.0-pre1	1,614	12/16/2015

3.x
- New portuguese accents (masculine or
- Continuous improvement, new diacritics mappings
- Bug fixes and performance improvements

2.1.0
- Performance improvements in RemoveDiacritics
- New method StaticDiacritics.SetDefaultMapper to replace the default IDiacriticsMapper
- Add vietnamese mappings

2.0.0
- Refactoring to NetStandard + NET 4.5.2
- Several bug fixes + new diacritics added

1.0.8
- Add Turkish ı mapping to i

1.0.7
- Support for .Net Standard 1.0
- Add Icelandic ð mapping to o

1.0.6
- Add Spanish ñ mapping to n

1.0.5
- Add support for combined cedilla characters
- Fix German ß mapping to ss

1.0.4
- Add .Net 4.5 implementation as dedicated assembly
- Add missing accents mappings
- Bug fix: Russian accents mapping fixed

1.0.3
- Bug fix: RemoveDiacritics now also removes upper case diacritic characters
- Bug fix: Correct handling of first letter upper case characters

1.0.2
- Improved initialization performance by factor 8

1.0.1
- 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