Added Span<T> example

exclusion.dic

@@ -61,4 +61,5 @@ Parksdale
 Monteray
 inigo
 Machava
-Uncompress
+Uncompress
+expialidocious

src/Chapter17.Tests/Listing17.09.SlicingWithSpan.Tests.cs

@@ -0,0 +1,17 @@
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_09.Tests;
+
+[TestClass]
+public class ProgramTests
+{
+    [TestMethod]
+    public void DictionaryInitialization()
+    {
+        IntelliTect.TestTools.Console.ConsoleAssert.Execute(null,
+        () =>
+        {
+            Program.Main();
+        });
+    }
+}

src/Chapter17.Tests/Listing17.11.DefiningAnIndexOperatorWithVariableParameters.Tests.cs → src/Chapter17.Tests/Listing17.12.DefiningAnIndexOperatorWithVariableParameters.Tests.cs

@@ -1,6 +1,6 @@
-using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
 
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_11.Tests;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_12.Tests;
 
 [TestClass]
 public class ProgramTests
@@ -15,4 +15,4 @@ public void IteratingABinaryTree()
         IntelliTect.TestTools.Console.ConsoleAssert.Expect(expected,
             Program.Main);
     }
-}
+}

src/Chapter17.Tests/Listing17.13.Tests.cs → src/Chapter17.Tests/Listing17.14.YieldingTheCSharpKeywordsSequentially.Tests.cs

@@ -1,6 +1,6 @@
-using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
 
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_13.Tests;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_14.Tests;
 
 [TestClass]
 public class ProgramTests
@@ -28,4 +28,4 @@ public void MainTest()
         IntelliTect.TestTools.Console.ConsoleAssert.Expect(
             expected, Program.Main);
     }
-}
+}

src/Chapter17.Tests/Listing17.15.Tests.cs → src/Chapter17.Tests/Listing17.16.UsingPair.GetEnumeratorViaForeach.Tests.cs

@@ -1,6 +1,6 @@
-using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
 
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_15.Tests;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_16.Tests;
 
 [TestClass]
 public class ProgramTests
@@ -14,4 +14,4 @@ public void MainTest()
         IntelliTect.TestTools.Console.ConsoleAssert.Expect(
             expected, Program.Main);
     }
-}
+}

src/Chapter17.Tests/Listing17.17.UsingForeachWithBinaryTree.Tests.cs → src/Chapter17.Tests/Listing17.18.UsingForeachWithBinaryTree.Tests.cs

@@ -1,6 +1,6 @@
-using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
 
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_17.Tests;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_18.Tests;
 
 [TestClass]
 public class ProgramTests
@@ -20,4 +20,4 @@ John Francis Fitzgerald
         IntelliTect.TestTools.Console.ConsoleAssert.Expect(expected,
             () => Program.Main());
     }
-}
+}

src/Chapter17.Tests/Listing17.20.Tests.cs → src/Chapter17.Tests/Listing17.21.UsingYieldReturnInAMethodThatReturnsIEnumberable.Tests.cs

@@ -1,6 +1,6 @@
-using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
 
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_20.Tests;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_21.Tests;
 
 [TestClass]
 public class ProgramTests
@@ -14,4 +14,4 @@ public void MainTest()
         IntelliTect.TestTools.Console.ConsoleAssert.Expect(
             expected, Program.Main);
     }
-}
+}

src/Chapter17/Chapter17.csproj

@@ -4,10 +4,13 @@
   </PropertyGroup>
   <Import Project="..\Chapter.props" />
   <ItemGroup>
-    <Compile Remove="Listing17.19.CSharpEquivalentOfCompilerGeneratedCodeForIterators.cs" />
+    <Compile Remove="Listing17.20.CSharpEquivalentOfCompilerGeneratedCodeForIterators.cs" />
   </ItemGroup>
   <ItemGroup>
-    <None Include="Listing17.19.CSharpEquivalentOfCompilerGeneratedCodeForIterators.cs" />
+    <None Remove="Listing17.07a.IteratingOverSortedDictionaryWithForeach.Placeholder.cs" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Include="Listing17.20.CSharpEquivalentOfCompilerGeneratedCodeForIterators.cs" />
     <Compile Include="..\Shared\Program.cs">
       <Link>Program.cs</Link>
     </Compile>

src/Chapter17/Listing17.09.SlicingWithSpan.cs

@@ -0,0 +1,51 @@
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_09;
+
+using System.Diagnostics;
+using System.Runtime.CompilerServices;
+
+public class Program
+{
+    public static void Main()
+    {
+        #region INCLUDE
+        string[] languages = new [] {
+            "C#", "COBOL", "Java",
+            "C++", "TypeScript", "Python",};
+
+        // Create a Span<string> from the arrays first 3 elements.
+        Span<string> languageSpan = languages.AsSpan(0, 2);
+        languages[0] = "R";
+        Assert(languages[0] == languageSpan[0]);
+        Assert("R" == languageSpan[0]);
+        languageSpan[0] = "Lisp";
+        Assert(languages[0] == languageSpan[0]);
+        Assert("Lisp" == languages[0]);
+
+        int[] numbers = languages.Select(item => item.Length).ToArray();
+        // Create a Span<string> from the arrays first 3 elements.
+        Span<int> numbersSpan = numbers.AsSpan(0, 2);
+        Assert(numbers[1] == numbersSpan[1]);
+        numbersSpan[1] = 42;
+        Assert(numbers[1] == numbersSpan[1]);
+        Assert(42 == numbers[1]);
+
+        const string bigWord = "supercalifragilisticexpialidocious";
+        // Create a Span<char> from a suffix portion of the word.
+        #if NET8_0_OR_GREATER
+        ReadOnlySpan<char> expialidocious = bigWord.AsSpan(20..);
+        #else // NET8_0_OR_GREATER
+        ReadOnlySpan<char> expialidocious = bigWord.AsSpan(20, 14);
+        #endif // NET8_0_OR_GREATER
+        Assert(expialidocious.ToString() == "expialidocious");
+#endregion INCLUDE
+    }
+
+    static void Assert(bool condition, 
+        [CallerArgumentExpression(nameof(condition))]string expression = null!)
+    {
+        if (!condition)
+        {
+            throw new Exception($"Assertion failed: {expression}");
+        }
+    }
+}

src/Chapter17/Listing17.09.DefiningAnIndexer.cs → src/Chapter17/Listing17.10.DefiningAnIndexer.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_09;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_10;
 
 using System;
 

src/Chapter17/Listing17.10.ChangingTheIndexersDefaultName.cs → src/Chapter17/Listing17.11.ChangingTheIndexersDefaultName.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_10;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_11;
 
 using System;
 

src/Chapter17/Listing17.11.DefiningAnIndexOperatorWithVariableParameters.cs → src/Chapter17/Listing17.12.DefiningAnIndexOperatorWithVariableParameters.cs

@@ -1,6 +1,6 @@
 using AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_10;
 
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_11;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_12;
 
 #region INCLUDE
 using System;

src/Chapter17/Listing17.12.IteratorInterfacesPattern.cs → src/Chapter17/Listing17.13.IteratorInterfacesPattern.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_12;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_13;
 
 #region INCLUDE
 using System.Collections;

src/Chapter17/Listing17.13.YieldingTheCSharpKeywordsSequentially.cs → src/Chapter17/Listing17.14.YieldingTheCSharpKeywordsSequentially.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_13;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_14;
 
 #region INCLUDE
 using System;

src/Chapter17/Listing17.14.UsingYieldToImplementBinaryTree.cs → src/Chapter17/Listing17.15.UsingYieldToImplementBinaryTree.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_14;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_15;
 
 using System;
 using Listing17_10;

src/Chapter17/Listing17.15.UsingPair.GetEnumeratorViaForeach.cs → src/Chapter17/Listing17.16.UsingPair.GetEnumeratorViaForeach.cs

@@ -1,7 +1,7 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_15;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_16;
 
 using System;
-using Listing17_14;
+using Listing17_15;
 
 public class Program
 {

src/Chapter17/Listing17.16.PlacingYieldReturnStatementsWithinALoop.cs → src/Chapter17/Listing17.17.PlacingYieldReturnStatementsWithinALoop.cs

@@ -1,7 +1,7 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_16;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_17;
 
 using System.Collections.Generic;
-using Listing17_14;
+using Listing17_15;
 #region INCLUDE
 public class BinaryTree<T> :
   IEnumerable<T>

src/Chapter17/Listing17.17.UsingForeachWithBinaryTree.cs → src/Chapter17/Listing17.18.UsingForeachWithBinaryTree.cs

@@ -1,8 +1,8 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_17;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_18;
 
 using System;
-using Listing17_14;
-using Listing17_16;
+using Listing17_15;
+using Listing17_17;
 
 public class Program
 {
@@ -38,4 +38,4 @@ public static void Main()
         #endregion HIGHLIGHT
         #endregion INCLUDE
     }
-}
+}

src/Chapter17/Listing17.18.EscapingIterationViaYieldBreak.cs → src/Chapter17/Listing17.19.EscapingIterationViaYieldBreak.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_18;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_19;
 
 using System;
 using Listing17_10;

src/Chapter17/Listing17.19.CSharpEquivalentOfCompilerGeneratedCodeForIterators.cs → src/Chapter17/Listing17.20.CSharpEquivalentOfCompilerGeneratedCodeForIterators.cs

@@ -1,10 +1,10 @@
-using AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_10;
+using AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_11;
 #region INCLUDE
 using System;
 using System.Collections;
 using System.Collections.Generic;
 #region EXCLUDE
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_19
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_20
 {
     #endregion EXCLUDE
     [NullableContext(1)]

src/Chapter17/Listing17.20.UsingYieldReturnInAMethodThatReturnsIEnumberable.cs → src/Chapter17/Listing17.21.UsingYieldReturnInAMethodThatReturnsIEnumberable.cs

@@ -1,4 +1,4 @@
-namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_20;
+namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter17.Listing17_21;
 
 using System;
 using Listing17_10;