From 2f7fcbe089b69859f1b218bacad94529b1eca1de Mon Sep 17 00:00:00 2001
From: Akram Shaari <xkre@users.noreply.github.com>
Date: Fri, 7 Dec 2018 05:26:16 +0800
Subject: [PATCH] Add C# 7 (#200)

* Added C# 7

* Some changes to Tuple Deconstruction section
---
 csharp7.md | 193 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 193 insertions(+)
 create mode 100644 csharp7.md

diff --git a/csharp7.md b/csharp7.md
new file mode 100644
index 000000000..19fca534a
--- /dev/null
+++ b/csharp7.md
@@ -0,0 +1,193 @@
+---
+title: C# 7
+category: others
+layout: 2017/sheet
+description: |
+  A quick overview of C# 7
+---
+
+### Out Variables
+
+```cs
+public void PrintCoordinates(Point p)
+{
+    p.GetCoordinates(out int x, out int y);
+    WriteLine($"({x}, {y})");
+}
+```
+
+`out` is used to declare a variable at the point where it is passed as an argument.
+
+### Pattern Matching
+
+#### Is-expressions with patterns
+
+```cs
+public void PrintStars(object o)
+{
+    if (o is null) return;     // constant pattern "null"
+    if (!(o is int i)) return; // type pattern "int i"
+    WriteLine(new string('*', i));
+}
+```
+
+#### Switch statements with patterns
+
+```cs
+switch(shape)
+{
+    case Circle c:
+        WriteLine($"circle with radius {c.Radius}");
+        break;
+    case Rectangle s when (s.Length == s.Height):
+        WriteLine($"{s.Length} x {s.Height} square");
+        break;
+    case Rectangle r:
+        WriteLine($"{r.Length} x {r.Height} rectangle");
+        break;
+    default:
+        WriteLine("<unknown shape>");
+        break;
+    case null:
+        throw new ArgumentNullException(nameof(shape));
+}
+```
+
+### Tuples
+
+#### Tuple type
+
+```cs
+(string, string, string) LookupName(long id) // tuple return type
+{
+    ... // retrieve first, middle and last from data storage
+    return (first, middle, last); // tuple literal
+}
+```
+
+```cs
+var names = LookupName(id);
+WriteLine($"found {names.Item1} {names.Item3}.");
+```
+
+#### Tuple elements with name
+
+```cs
+(string first, string middle, string last) LookupName(long id) // tuple elements have names
+```
+
+```cs
+var names = LookupName(id);
+WriteLine($"found {names.first} {names.last}.");
+```
+
+#### Tuple Literals
+
+```cs
+   return (first: first, middle: middle, last: last); // named tuple elements in a literal
+```
+
+#### Tuple Deconstruction
+
+```cs
+(var first, var middle, var last) = LookupName(id1);
+WriteLine($"found {first} {last}.");
+```
+or
+```cs
+var (first, middle, last) = LookupName(id1); // var outside
+```
+or
+```cs
+(first, middle, last) = LookupName(id2); // assign onto existing variables
+```
+
+
+### Local Functions
+
+```cs
+public int Fibonacci(int x)
+{
+    if (x < 0) throw new ArgumentException("Less negativity please!", nameof(x));
+    return Fib(x).current;
+
+    (int current, int previous) Fib(int i)
+    {
+        if (i == 0) return (1, 0);
+        var (p, pp) = Fib(i - 1);
+        return (p + pp, p);
+    }
+}
+```
+
+### Literal Improvements
+
+#### Digit Separator inside numbers literals
+
+```cs
+var d = 123_456;
+var x = 0xAB_CD_EF;
+```
+
+#### Binary Literals
+
+```cs
+var b = 0b1010_1011_1100_1101_1110_1111;
+```
+
+### Ref Returns and Locals
+
+```cs
+public ref int Find(int number, int[] numbers)
+{
+    for (int i = 0; i < numbers.Length; i++)
+    {
+        if (numbers[i] == number) 
+        {
+            return ref numbers[i]; // return the storage location, not the value
+        }
+    }
+    throw new IndexOutOfRangeException($"{nameof(number)} not found");
+}
+
+int[] array = { 1, 15, -39, 0, 7, 14, -12 };
+ref int place = ref Find(7, array); // aliases 7's place in the array
+place = 9; // replaces 7 with 9 in the array
+WriteLine(array[4]); // prints 9
+```
+
+### More Expression Bodied Members
+
+C# 7.0 adds accessors, constructors and finalizers to the list of things that can have expression bodies:
+
+```cs
+class Person
+{
+    private static ConcurrentDictionary<int, string> names = new ConcurrentDictionary<int, string>();
+    private int id = GetId();
+
+    public Person(string name) => names.TryAdd(id, name); // constructors
+    ~Person() => names.TryRemove(id, out *);              // destructors
+    public string Name
+    {
+        get => names[id];                                 // getters
+        set => names[id] = value;                         // setters
+    }
+}
+```
+
+### Throw Expressions 
+
+```cs
+class Person
+{
+    public string Name { get; }
+    public Person(string name) => Name = name ?? throw new ArgumentNullException(name);
+    public string GetFirstName()
+    {
+        var parts = Name.Split(" ");
+        return (parts.Length > 0) ? parts[0] : throw new InvalidOperationException("No name!");
+    }
+    public string GetLastName() => throw new NotImplementedException();
+}
+```