example of tuples, deconstruction, and discards

ClarityConciseness/TupleDeconstruction/TupleDeconstruction.sln

@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.4.33110.190
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TupleDeconstruction", "TupleDeconstruction\TupleDeconstruction.csproj", "{7D5DB90E-9E85-4AA1-95C3-55DDF5A7F405}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{7D5DB90E-9E85-4AA1-95C3-55DDF5A7F405}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7D5DB90E-9E85-4AA1-95C3-55DDF5A7F405}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7D5DB90E-9E85-4AA1-95C3-55DDF5A7F405}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7D5DB90E-9E85-4AA1-95C3-55DDF5A7F405}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {DC4A4177-557C-4DE9-8BC4-0DE3BFEAF71A}
+	EndGlobalSection
+EndGlobal

ClarityConciseness/TupleDeconstruction/TupleDeconstruction/App.config

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<configuration>
+    <startup> 
+        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7.2" />
+    </startup>
+</configuration>

ClarityConciseness/TupleDeconstruction/TupleDeconstruction/Form1.cs

@@ -0,0 +1,89 @@
+using System;
+using System.Windows.Forms;
+
+namespace TupleDeconstruction
+{
+    public partial class Form1 : Form
+    {
+        public Form1()
+        {
+            InitializeComponent();
+        }
+
+        private void Form1_Load(object sender, EventArgs e)
+        {
+            void Write(string text) => txtOutput.AppendText($"{text}\r\n");
+            void WriteHeader(string text) => txtOutput.AppendText($"\r\n============================\r\n{text}\r\n============================\r\n");
+
+
+            // Access each tuple element individually
+            WriteHeader("Access each tuple element individually");
+
+            var circle = GetCircle(3);
+
+            Write($"Diameter: {circle.diameter}");               // 6
+            Write($"Circumference: {circle.circumference:N2}");  // 18.85
+            Write($"Area: {circle.area:N2}");                    // 28.27
+
+            // Deconstruct the tuple elements into separate local variables
+            WriteHeader("Deconstruct the tuple elements into separate local variables");
+
+            var (diameter, circumference, area) = GetCircle(3);
+
+            Write($"Diameter: {diameter}");                      // 6
+            Write($"Circumference: {circumference:N2}");         // 18.85
+            Write($"Area: {area:N2}");                           // 28.27
+
+            // You can even compare tuples...
+            Write($"\r\nAre these equal? {circle == (diameter, circumference, area)}");  // true
+
+            // Deconstruct the tuple elements and discard the ones you don't need
+            WriteHeader("Deconstruct the tuple elements and discard the ones you don't need");
+
+            var (_, _, area2) = GetCircle(5);
+
+            Write($"Area: {area2:N2}");                          // 78.54
+
+            // Or just access the tuple element directly if that's all you need
+            WriteHeader("Access the tuple element directly");
+
+            Write($"Diameter: {GetCircle(10).diameter}");        // 20
+
+            // Using 'out' variables instead of tuples
+            WriteHeader("Using 'out' variables instead of tuples");
+
+            GetCircle(6, out var diameter3, out var circumference3, out var area3);
+
+            Write($"Diameter: {diameter3}");                     // 12
+            Write($"Circumference: {circumference3:N2}");        // 37.70
+            Write($"Area: {area3:N2}");                          // 113.10
+        }
+
+        private (int diameter, double circumference, double area) GetCircle(int radius)
+        {
+            var diameter = radius * 2;
+            var circumference = Math.PI * diameter;
+            var area = Math.PI * Math.Pow(radius, 2);
+
+            return (diameter, circumference, area);
+        }
+
+        private void GetCircle(int radius, out int diameter, out double circumference, out double area)
+        {
+            diameter = radius * 2;
+            circumference = Math.PI * diameter;
+            area = Math.PI * Math.Pow(radius, 2);
+        }
+    }
+
+    public class Circle
+    {
+        int radius;
+
+        public Circle(int radius) => this.radius = radius;
+
+        public int Diameter => radius * 2;
+        public double Circumference => Math.PI * Diameter;
+        public double Area => Math.PI * Math.Pow(radius, 2);
+    }
+}

ClarityConciseness/TupleDeconstruction/TupleDeconstruction/Form1.resx

@@ -0,0 +1,120 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!-- 
+    Microsoft ResX Schema 
+    
+    Version 2.0
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
+    associated with the data types.
+    
+    Example:
+    
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+                
+    There are any number of "resheader" rows that contain simple 
+    name/value pairs.
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
+    mimetype set.
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
+    extensible. For a given mimetype the value must be set accordingly:
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
+    read any of the formats listed below.
+    
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+    
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array 
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+</root>

ClarityConciseness/TupleDeconstruction/TupleDeconstruction/Program.cs

@@ -0,0 +1,22 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using System.Windows.Forms;
+
+namespace TupleDeconstruction
+{
+    internal static class Program
+    {
+        /// <summary>
+        /// The main entry point for the application.
+        /// </summary>
+        [STAThread]
+        static void Main()
+        {
+            Application.EnableVisualStyles();
+            Application.SetCompatibleTextRenderingDefault(false);
+            Application.Run(new Form1());
+        }
+    }
+}

ClarityConciseness/TupleDeconstruction/TupleDeconstruction/Properties/AssemblyInfo.cs

@@ -0,0 +1,36 @@
+using System.Reflection;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+
+// General Information about an assembly is controlled through the following
+// set of attributes. Change these attribute values to modify the information
+// associated with an assembly.
+[assembly: AssemblyTitle("TupleDeconstruction")]
+[assembly: AssemblyDescription("")]
+[assembly: AssemblyConfiguration("")]
+[assembly: AssemblyCompany("")]
+[assembly: AssemblyProduct("TupleDeconstruction")]
+[assembly: AssemblyCopyright("Copyright ©  2023")]
+[assembly: AssemblyTrademark("")]
+[assembly: AssemblyCulture("")]
+
+// Setting ComVisible to false makes the types in this assembly not visible
+// to COM components.  If you need to access a type in this assembly from
+// COM, set the ComVisible attribute to true on that type.
+[assembly: ComVisible(false)]
+
+// The following GUID is for the ID of the typelib if this project is exposed to COM
+[assembly: Guid("7d5db90e-9e85-4aa1-95c3-55ddf5a7f405")]
+
+// Version information for an assembly consists of the following four values:
+//
+//      Major Version
+//      Minor Version
+//      Build Number
+//      Revision
+//
+// You can specify all the values or you can default the Build and Revision Numbers
+// by using the '*' as shown below:
+// [assembly: AssemblyVersion("1.0.*")]
+[assembly: AssemblyVersion("1.0.0.0")]
+[assembly: AssemblyFileVersion("1.0.0.0")]