nuget package

README.md

@@ -2,7 +2,7 @@
 [![NuGet](https://img.shields.io/nuget/v/FolkerKinzel.Strings)](https://www.nuget.org/packages/FolkerKinzel.Strings/)
 [![GitHub](https://img.shields.io/github/license/FolkerKinzel/Strings)](https://github.com/FolkerKinzel/Strings/blob/master/LICENSE)
 
-[Project Reference and Release Notes](https://github.com/FolkerKinzel/Strings/releases/tag/v6.0.0)
+[Project Reference and Release Notes](https://github.com/FolkerKinzel/Strings/releases/tag/v6.1.0)
 
 .NET library that contains extension methods and helper classes for character-based data types.
 

src/FolkerKinzel.Strings/FolkerKinzel.Strings.csproj

@@ -1,5 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup Condition="True And '$(Configuration)'=='Release' And '$(TargetFramework)' == 'netstandard2.0'">
+  <PropertyGroup Condition="False And '$(Configuration)'=='Release' And '$(TargetFramework)' == 'netstandard2.0'">
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
   <PropertyGroup>
@@ -11,8 +11,8 @@
     <!-- nuget-Package: -->
     <PackageId>FolkerKinzel.Strings</PackageId>
     <Product>FolkerKinzel.Strings</Product>
-    <Version>6.0.0</Version>
-    <FileVersion>6.0.0.25</FileVersion>
+    <Version>6.1.0</Version>
+    <FileVersion>6.1.0.2</FileVersion>
     <AssemblyVersion>6.0.0.0</AssemblyVersion>
     <PackageReleaseNotes>https://github.com/FolkerKinzel/Strings/releases/tag/v6.1.0</PackageReleaseNotes>
     <PackageTags>.NET String Polyfill StringBuilder ReadOnlySpan ReadOnlyMemory Char Hashcode C#</PackageTags>

src/FolkerKinzel.Strings/Polyfills/StringBuilderExtensionPolyfillExtension.cs

@@ -25,7 +25,8 @@ public static class StringBuilderExtensionPolyfillExtension
     /// 
     /// <returns>Ein Verweis auf <paramref name="builder"/>, nachdem der Anfügevorgang abgeschlossen wurde.</returns>
     /// 
-    /// <remarks>Die Methode ersetzt alle Zeichen mit Ausnahme von nicht reservierten RFC 3986-Zeichen in ihre hexadezimale 
+    /// <remarks>Die Methode ersetzt alle Zeichen in <paramref name="value"/> mit Ausnahme von nicht reservierten RFC 3986-Zeichen 
+    /// durch ihre hexadezimale 
     /// Darstellung. Alle Unicode-Zeichen werden in das UTF-8-Format konvertiert, bevor sie mit Escapezeichen versehen werden.
     /// Bei dieser Methode wird davon ausgegangen, dass in <paramref name="value"/> keine Escapesequenzen enthalten sind.</remarks>
     /// 

src/FolkerKinzel.Strings/StringBuilderExtension_AppendUrlEncoded.cs

@@ -14,7 +14,8 @@ public static partial class StringBuilderExtension
     /// 
     /// <returns>Ein Verweis auf <paramref name="builder"/>, nachdem der Anfügevorgang abgeschlossen wurde.</returns>
     /// 
-    /// <remarks>Die Methode ersetzt alle Zeichen mit Ausnahme von nicht reservierten RFC 3986-Zeichen in ihre hexadezimale 
+    /// <remarks>Die Methode ersetzt alle Zeichen in <paramref name="value"/> mit Ausnahme von nicht reservierten RFC 3986-Zeichen 
+    /// durch ihre hexadezimale 
     /// Darstellung. Alle Unicode-Zeichen werden in das UTF-8-Format konvertiert, bevor sie mit Escapezeichen versehen werden.
     /// Bei dieser Methode wird davon ausgegangen, dass in <paramref name="value"/> keine Escapesequenzen enthalten sind.</remarks>
     /// 

src/FolkerKinzel.Strings/StringBuilderExtension_Replace.cs

@@ -11,7 +11,7 @@ public static partial class StringBuilderExtension
     /// <param name="builder">Der <see cref="StringBuilder"/>, dessen Inhalt geändert wird.</param>
     /// <param name="oldValue">Die zu ersetzende Zeichenfolge.</param>
     /// <param name="newValue">Die Zeichenfolge, die <paramref name="oldValue"/> ersetzt, oder <c>null</c>.</param>
-    /// <param name="startIndex">Die Position in dieser Instanz, an der die Teilzeichenfolge beginnt.</param>
+    /// <param name="startIndex">Die Position in <paramref name="builder"/>, an der die Teilzeichenfolge beginnt.</param>
     /// <returns>Ein Verweis auf <paramref name="builder"/>, bei dem alle Instanzen von <paramref name="oldValue"/>
     /// im Bereich von <paramref name="startIndex"/> bis zum Ende von <paramref name="builder"/> durch
     /// <paramref name="newValue"/> ersetzt wurden.</returns>
@@ -43,7 +43,7 @@ public static StringBuilder Replace(this StringBuilder builder, string oldValue,
     /// <param name="builder">Der <see cref="StringBuilder"/>, dessen Inhalt geändert wird.</param>
     /// <param name="oldChar">Das zu ersetzende Zeichen.</param>
     /// <param name="newChar">Das Zeichen, das <paramref name="oldChar"/> ersetzt.</param>
-    /// <param name="startIndex">Die Position in dieser Instanz, an der die Teilzeichenfolge beginnt.</param>
+    /// <param name="startIndex">Die Position in <paramref name="builder"/>, an der die Teilzeichenfolge beginnt.</param>
     /// 
     /// <returns>Ein Verweis auf <paramref name="builder"/>, bei dem <paramref name="oldChar"/>
     /// im Bereich von <paramref name="startIndex"/> bis zum Ende von <paramref name="builder"/> durch

src/FolkerKinzel.Strings/Translations/FolkerKinzel.Strings.en.tsltn

@@ -1943,21 +1943,18 @@ Do not use the hashcodes generated by this method for security-critical purposes
   <T ID="35016CC34EA50E59">The &lt;see cref="T:System.Text.StringBuilder"/&gt; to append characters to.</T>
   <T ID="C8B499A34F360E90">The &lt;see cref="T:System.String"/&gt; containing the characters to encode and append, or &lt;c&gt;null&lt;/c&gt;.</T>
   <T ID="714098372DE8164">A reference to &lt;paramref name="builder"/&gt; after the append operation has completed.</T>
-  <T ID="4CF599AF6D641D40">The method replaces all characters except unreserved RFC 3986 characters into their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. This method assumes that there are no escape sequences in &lt;paramref name="value"/&gt;.</T>
   <T ID="61B77F0B6D12D017">&lt;paramref name="builder"/&gt; is &lt;c&gt;null&lt;/c&gt;.</T>
   <T ID="ADBED3BCC5B973E4">Increasing the capacity of &lt;paramref name="builder"/&gt; would exceed &lt;see cref="P:System.Text.StringBuilder.MaxCapacity"/&gt;.</T>
   <T ID="F0D3CF3EF04F987">Appends the content of a read-only character span as URL-encoded string to the end of a &lt;see cref="T:System.Text.StringBuilder"/&gt;.</T>
   <T ID="E291A7EC4EA50E59">The &lt;see cref ="T:System.Text.StringBuilder"/&gt; to which the characters are appended.</T>
   <T ID="8FCBCCB15D02B325">The read-only character span that provides the characters that have to be encoded and appended.</T>
   <T ID="5E61F35E72DE8164">A reference to &lt;paramref name="builder"/&gt; after the append operation has completed.</T>
-  <T ID="85DBF4026D641D40">The method replaces all characters except unreserved RFC 3986 characters into their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. This method assumes that there are no escape sequences in &lt;paramref name="value"/&gt;.</T>
   <T ID="4D4511CE6D12D017">&lt;paramref name="builder"/&gt; is &lt;c&gt;null&lt;/c&gt;.</T>
   <T ID="BD66A3E4C5B973E4">Increasing the capacity of &lt;paramref name="builder"/&gt; would exceed &lt;see cref="P:System.Text.StringBuilder.MaxCapacity"/&gt;.</T>
   <T ID="930F7D0BA287C485">Replaces all occurrences of a specified string in a substring of &lt;paramref name="builder"/&gt; with another specified string.</T>
   <T ID="1B918167FDCAD05B">The &lt;see cref ="T:System.Text.StringBuilder"/&gt; whose content is changed.</T>
   <T ID="3CD78B81A9D8FD4E">The string to replace.</T>
   <T ID="CF0C93569A84DB85">The string that replaces &lt;paramref name="oldValue"/&gt;, or &lt;c&gt;null&lt;/c&gt;.</T>
-  <T ID="659449DCAE7D5B00">The position in this instance where the substring begins.</T>
   <T ID="77D078AC9EF368EF">A reference to &lt;paramref name="builder"/&gt; with all instances of &lt;paramref name="oldValue"/&gt; replaced by &lt;paramref name="newValue"/&gt; in the range from &lt;paramref name="startIndex"/&gt; to the end of &lt;paramref name="builder"/&gt;.</T>
   <T ID="6BAC8A0B6FCC8A">This method performs an ordinal, case-sensitive comparison to identify occurrences of &lt;paramref name="oldValue"/&gt; in the specified substring. If &lt;paramref name="newValue"/&gt; is &lt;c&gt;null&lt;/c&gt; or &lt;see cref="F:System.String.Empty"/&gt;, all occurrences of &lt;paramref name="oldValue"/&gt; are removed.</T>
   <T ID="29B20F510F9D98FA">&lt;paramref name="builder"/&gt; or &lt;paramref name="oldValue"/&gt; is &lt;c&gt;null&lt;/c&gt;.</T>
@@ -1980,4 +1977,61 @@ Increasing the capacity of &lt;paramref name="builder"/&gt; would exceed &lt;see
   <T ID="1EF6423D41E4804B">Replaces, within a substring of &lt;paramref name="builder"/&gt;, all occurrences of a specified character with another specified character.</T>
   <T ID="F40983B5FDCAD05B">The &lt;see cref ="T:System.Text.StringBuilder"/&gt; whose content is changed.</T>
   <T ID="8069C2A3B154A0B6">The character to replace.</T>
+  <T ID="D53A1C424D058AEB">The character that replaces &lt;paramref name="oldChar"/&gt;.</T>
+  <T ID="659449DC3138F6F4">The position in &lt;paramref name="builder"/&gt; where the substring begins.</T>
+  <T ID="212BEB9F3138F6F4">The position in &lt;paramref name="builder"/&gt; where the substring begins.</T>
+  <T ID="BAD8045EBE397B86">A reference to &lt;paramref name="builder"/&gt; with &lt;paramref name="oldChar"/&gt; replaced by &lt;paramref name="newChar"/&gt; in the range from &lt;paramref name="startIndex"/&gt; to the end of &lt;paramref name="builder"/&gt;.</T>
+  <T ID="F4F2E4D6F6223C9D">This method performs an ordinal, case-sensitive comparison to identify occurrences of &lt;paramref name="oldChar"/&gt; in the current instance. The size of &lt;paramref name="builder"/&gt; is unchanged after the replacement.</T>
+  <T ID="F40E135A6D12D017">&lt;paramref name="builder"/&gt; is &lt;c&gt;null&lt;/c&gt;.</T>
+  <T ID="CCDED6859651633B">&lt;para&gt;
+&lt;paramref name="startIndex"/&gt; is less than zero.
+&lt;/para&gt;
+&lt;para&gt;
+- or -
+&lt;/para&gt;
+&lt;para&gt;
+&lt;paramref name="startIndex"/&gt; indicates a character position not within  &lt;paramref name="builder"/&gt;.
+&lt;/para&gt;</T>
+  <T ID="4FCBA90BB54071E4">Static class that provides methods for handling URL encoding (RFC 3986).</T>
+  <T ID="5981E12F29331ECA">Tries to decode a URL-encoded &lt;see cref="T:System.String"/&gt; using a specified character set and allows to specify whether or not PLUS characters ('+', U+002B) should be decoded as SPACE characters (' ', U+0020).</T>
+  <T ID="407CB1D237C07BA0">The &lt;see cref="T:System.String"/&gt; to decode.</T>
+  <T ID="480698740420BE21">The standardized web name of the character set to use or &lt;c&gt;null&lt;/c&gt; or &lt;see cref="F:System.String.Empty"/&gt; as a replacement for "utf-8".</T>
+  <T ID="A0ED82F0DF381012">&lt;c&gt;true&lt;/c&gt; to decode PLUS characters ('+', U+002B) as SPACE characters (' ', U+0020), or  &lt;c&gt;false&lt;/c&gt; to include the PLUS characters unchanged in &lt;paramref name="decoded"/&gt;.</T>
+  <T ID="8F69552FC7283F24">After the method completes successfully, contains a &lt;see cref="T:System.String"/&gt; that represents the decoded content of &lt;paramref name="value"/&gt;.</T>
+  <T ID="109EB75EB05F584C">&lt;c&gt;true&lt;/c&gt; if the decoding was successful, otherwise &lt;c&gt;false&lt;/c&gt;.</T>
+  <T ID="D5B6BAABE034A1D5">Tries to decode a URL-encoded &lt;see cref="T:System.String"/&gt; using a specified code page and allows to specify whether or not PLUS characters ('+', U+002B) should be decoded as SPACE characters (' ', U+0020).</T>
+  <T ID="AEC57DA537C07BA0">The &lt;see cref="T:System.String"/&gt; to decode.</T>
+  <T ID="D52FC4221C7D5BA4">The code page to use.</T>
+  <T ID="C87E05BDF381012">&lt;c&gt;true&lt;/c&gt; to decode PLUS characters ('+', U+002B) as SPACE characters (' ', U+0020), or  &lt;c&gt;false&lt;/c&gt; to include the PLUS characters unchanged in &lt;paramref name="decoded"/&gt;.</T>
+  <T ID="83717F5DC7283F24">After the method completes successfully, contains a &lt;see cref="T:System.String"/&gt; that represents the decoded content of &lt;paramref name="value"/&gt;.</T>
+  <T ID="F10224EEB05F584C">&lt;c&gt;true&lt;/c&gt; if the decoding was successful, otherwise &lt;c&gt;false&lt;/c&gt;.</T>
+  <T ID="F7F68641B05F584C">&lt;c&gt;true&lt;/c&gt; if the decoding was successful, otherwise &lt;c&gt;false&lt;/c&gt;.</T>
+  <T ID="FA5A9632B05F584C">&lt;c&gt;true&lt;/c&gt; if the decoding was successful, otherwise &lt;c&gt;false&lt;/c&gt;.</T>
+  <T ID="FDCBE55CB05F584C">&lt;c&gt;true&lt;/c&gt; if the decoding was successful, otherwise &lt;c&gt;false&lt;/c&gt;.</T>
+  <T ID="DA6B9D40B05F584C">&lt;c&gt;true&lt;/c&gt; if the decoding was successful, otherwise &lt;c&gt;false&lt;/c&gt;.</T>
+  <T ID="2F6C1A793DC2E5A"></T>
+  <T ID="A14E07522D2816FE"></T>
+  <T ID="9F26DB402D2816FE"></T>
+  <T ID="618848D52D2816FE"></T>
+  <T ID="441267AC2D2816FE"></T>
+  <T ID="585989FBC7283F24">After the method completes successfully, contains a &lt;see cref="T:System.String"/&gt; that represents the decoded content of &lt;paramref name="value"/&gt;.</T>
+  <T ID="9D979695C7283F24">After the method completes successfully, contains a &lt;see cref="T:System.String"/&gt; that represents the decoded content of &lt;paramref name="value"/&gt;.</T>
+  <T ID="AC77A28AC7283F24">After the method completes successfully, contains a &lt;see cref="T:System.String"/&gt; that represents the decoded content of &lt;paramref name="value"/&gt;.</T>
+  <T ID="3710A140C7283F24">After the method completes successfully, contains a &lt;see cref="T:System.String"/&gt; that represents the decoded content of &lt;paramref name="value"/&gt;.</T>
+  <T ID="D414B952DF381012">&lt;c&gt;true&lt;/c&gt; to decode PLUS characters ('+', U+002B) as SPACE characters (' ', U+0020), or  &lt;c&gt;false&lt;/c&gt; to include the PLUS characters unchanged in &lt;paramref name="decoded"/&gt;.</T>
+  <T ID="D33B5E69DF381012">&lt;c&gt;true&lt;/c&gt; to decode PLUS characters ('+', U+002B) as SPACE characters (' ', U+0020), or  &lt;c&gt;false&lt;/c&gt; to include the PLUS characters unchanged in &lt;paramref name="decoded"/&gt;.</T>
+  <T ID="180478E7DF381012">&lt;c&gt;true&lt;/c&gt; to decode PLUS characters ('+', U+002B) as SPACE characters (' ', U+0020), or  &lt;c&gt;false&lt;/c&gt; to include the PLUS characters unchanged in &lt;paramref name="decoded"/&gt;.</T>
+  <T ID="36D8E8D7DF381012">&lt;c&gt;true&lt;/c&gt; to decode PLUS characters ('+', U+002B) as SPACE characters (' ', U+0020), or  &lt;c&gt;false&lt;/c&gt; to include the PLUS characters unchanged in &lt;paramref name="decoded"/&gt;.</T>
+  <T ID="494CE1D937C07BA0">The &lt;see cref="T:System.String"/&gt; to decode.</T>
+  <T ID="7E2ABC7A1C7D5BA4">The code page to use.</T>
+  <T ID="CB06239DE8909EF0">The read-only character span to decode.</T>
+  <T ID="12D227F9E8909EF0">The read-only character span to decode.</T>
+  <T ID="6F8270C8E8909EF0">The read-only character span to decode.</T>
+  <T ID="6623B75E0420BE21">The standardized web name of the character set to use or &lt;c&gt;null&lt;/c&gt; or &lt;see cref="F:System.String.Empty"/&gt; as a replacement for "utf-8".</T>
+  <T ID="46DE6D0412B4F9E0">Tries to decode a URL-encoded &lt;see cref="T:System.String"/&gt; using the UTF-8 character set and allows to specify whether or not PLUS characters ('+', U+002B) should be decoded as SPACE characters (' ', U+0020).</T>
+  <T ID="3FDA18F7169D9CC5">Tries to decode a URL-encoded read-only character span using a specified character set and allows to specify whether or not PLUS characters ('+', U+002B) should be decoded as SPACE characters (' ', U+0020).</T>
+  <T ID="BE1617CFECD3D200">Tries to decode a URL-encoded read-only character span using a specified code page and allows to specify whether or not PLUS characters ('+', U+002B) should be decoded as SPACE characters (' ', U+0020).</T>
+  <T ID="B10E66117B1B539F">Tries to decode a URL-encoded read-only character span using the UTF-8 character set and allows to specify whether or not PLUS characters ('+', U+002B) should be decoded as SPACE characters (' ', U+0020).</T>
+  <T ID="4CF599AF7C1676E9">The method replaces all characters in &lt;paramref name="value"/&gt; except unreserved RFC 3986 characters into their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. This method assumes that there are no escape sequences in &lt;paramref name="value"/&gt;.</T>
+  <T ID="85DBF4027C1676E9">The method replaces all characters in &lt;paramref name="value"/&gt; except unreserved RFC 3986 characters into their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. This method assumes that there are no escape sequences in &lt;paramref name="value"/&gt;.</T>
 </Tsltn>