Tuples and Classes
Tuples and Classes
Fundamentals of Tuples and Classes
Introduction
We saw how to declare tuple variables. In the same way, you can declare a tuple variable in the body of a class, in which case the variable is treated as a field. Here is an example:
public class Processor
{
/* We are combining these pieces of information of the
* processor because processors specifications are
* related by generation and tied to a manufacturer. */
(string make, string model) identification;
}
Practical Learning: Introducing Conditions
namespace PayrollPreparation6.Models { internal class Employee { internal required int EmployeeNumber { get; set; } internal required string FirstName { get; set; } internal required string LastName { get; set; } internal required double HourlySalary { get; set; } } }
namespace PayrollPreparation6.Models { internal class TimeSheet { internal required int TimeSheetNumber { get; set; } internal required int EmployeeNumber { get; set; } internal required double Monday { get; set; } internal required double Tuesday { get; set; } internal required double Wednesday { get; set; } internal required double Thursday { get; set; } internal required double Friday { get; set; } private double GetSalary() { if (EmployeeNumber == 370_595) { return 28.25; } else if (EmployeeNumber == 826_384) { return 24.37; } else if (EmployeeNumber == 175_004) { return 26.97; } else if (EmployeeNumber == 697_415) { return 31.57; } else return 0.00; } internal double TimeWorked { get { return Monday + Tuesday + Wednesday + Thursday + Friday; } } } }
Initializing a Tuple
As you may know already, a constructor is a special method that is used to initialize a variable or a field. Therefore, if you create a regular tuple field, you can use a constructor to initialize it. Here is an example:
public class Processor { /* We are combining these pieces of information of the * processor because processors specifications are * related by generation and tied to a manufacturer. */ (string make, string model) identification; public Processor() { identification = ("HP", "XL2X0 GEN9 E5-2620V3"); } }
A Read-Only Tuple
You can create a constant tuple but whose value depends on specific objects. This is the case for a read-only tuple. You can create it in the body of a class and initialize it in a constructor. Here is an example:
public class Memory { public readonly (int numberOfSockets, int memoryInGB) partition; public Memory() { partition = (2, 8); } public Memory(int capacity) { partition = (2, 16); } }
Initializing the Properties of a Class
Consider a class as follows:
public class Trapezoid { public double Bottom { get; set; } public double Top { get; set; } public double Height { get; set; } public Trapezoid(double bottom, double height) { Bottom = bottom; Height = height; } public Trapezoid(double bottom, double top, double height) { Bottom = bottom; Top = top; Height = height; } }
Notice that the class has an overloaded constructor with one constructor that takes two arguments and the constructor that takes three arguments. Also notice that, to initialize the properties, each constructor assigns the desired value or a parameterized value to a property. Using the characteristics of a tuple, you can initialize the properties by putting them in parentheses and assigning another set of parentheses to it. In the second parentheses, pur a list of the values for the parentheses. The values must be in the order of the properties in the first set of parentheses. These can be done as follows:
using static System.Console; Trapezoid trap = new Trapezoid(708.83, 140.07); WriteLine("==========================="); WriteLine("Trapezoid"); WriteLine("---------------------------"); WriteLine("Top: {0}", trap.Top); WriteLine("Bottom: {0}", trap.Bottom); WriteLine("Height: {0}", trap.Height); WriteLine("---------------------------"); WriteLine("Area: {0}", trap.Area); WriteLine("==========================="); trap = new Trapezoid(708.83, 486.39, 140.07); WriteLine("Trapezoid"); WriteLine("---------------------------"); WriteLine("Top: {0}", trap.Top); WriteLine("Bottom: {0}", trap.Bottom); WriteLine("Height: {0}", trap.Height); WriteLine("---------------------------"); WriteLine("Area: {0}", trap.Area); WriteLine("==========================="); public class Trapezoid { private double _top_; public double Bottom { get; set; } public double Height { get; set; } public Trapezoid(double bottom, double height) { (Bottom, Height) = (bottom, height); } public Trapezoid(double bottom, double top, double height) { (Bottom, Top, Height) = (bottom, top, height); } public double Top { get { if (_top_ == 0.00) return Bottom * .75; return _top_; } set { _top_ = value; } } public double Area { get { return ((Bottom + Top) / 2.00) * Height; } } }
This would produce:
=========================== Trapezoid --------------------------- Top: 531.6225000000001 Bottom: 708.83 Height: 140.07 --------------------------- Area: 86875.0908375 =========================== Trapezoid --------------------------- Top: 486.39 Bottom: 708.83 Height: 140.07 --------------------------- Area: 83707.2327 =========================== Press any key to close this window . . .
Method Overloading and Tuples
In our introduction to method overloading, we saw that a method can get overloaded if you create more than one version in the same class. We also saw that the versions of the method must differ by their syntax or signature. Remember that the signature of a method doesn't include its return type. Based on this, you cannot overload a method based on the fact that one version returns a tuple and another does not.
To overload a method that involves tuples, you will rely on the parameters. You can create a method that has different versions. Two or more versions of a method can take one tuple parameter each; each tuple-parameter can have the same number of elements but the elements can be different. Consider the following example:
public class Algebra { /* The following two versions of an overloaded method take one tuple * as parameter, but each tuple-parameter has different types of parameters. */ void Calculate((string, string) a) { } void Calculate((string, double) a) { } /* The following additional three versions of an overloaded method take * one tuple as parameter, but each tuple-parameter has different number of parameters. */ void Calculate((int, bool) a) { } void Calculate((string, int, double) a) { } void Calculate((string, int, bool, double) a) { } }
On the other hand, you can overload a method by passing a mixture of primitive types and tuples.
Tuples and Properties
Introduction
You can create a property whose type is a tuple. To start, in the body of the class, you can declare a field variable that is a tuple type. Here is an example:
public class Member
{
public (int, string, double) id;
}
To get the property, create a property that has a return type as a tuple. Here is an example:
public class Member
{
private (int, string, double) id;
public (int, string, double) Identification
{
}
}
A Read-Only Tuple Property
A read-only property is a a property with only a get clause. For a tuple property, make the get clause return a private field that has the same return type as the property. Here is an example:
public class Member
{
private (int, string, double) id;
public (int, string, double) Identification
{
get
{
return id;
}
}
}
If you want to use the property outside its class, it must have a value, which it cannot get on its own because it is a read-only property. The most common way you can initialize this property is by using a constructor that uses a parameter of the same tuple type as the property. After initializing the property, you can get its value and use it. Here is an example:
using static System.Console; (int nbr, string name, double fee) account = (295_380, "Elisabeth Merlins", 98.50); Member mbr = new Member(account, 0); WriteLine("Membership Details"); WriteLine("-------------------------------"); WriteLine($"Member #: {mbr.Identification.number}"); WriteLine($"Full Name: {mbr.Identification.name}"); WriteLine($"Account Fee: {mbr.Identification.fee}"); WriteLine("==============================="); public class Member { private (int, string, double) id; public Member((int, string, double) identifier, int amt) { id = identifier; } public (int number, string name, double fee) Identification { get { return id; } } }
This would produce:
Membership Details ------------------------------- Member #: 295380 Full Name: Elisabeth Merlins Account Fee: 98.5 =============================== Press any key to close this window . . .
A Fully-Implemented Tuple Property
As seen in our introduction to properties, if you want to control the details of processing a property, you can create a private field that is the same tuple type as the property. Then add either or both a get and a set clauses. Here is an example:
public class Employee { private (int, string, bool) id; public (int, string, bool) Identification { get { return id; } set { id = value; } } }
An Automatic Tuple Property
If you are not planning to validate, accept, or reject the values of the property, you can create the property as an automatic one. Here is an example:
public enum PayFrequency { Daily, Monthly, Yearly }
public class Employee
{
private (int, string, bool) id;
public (int, string, bool) Identification
{
get
{
return id;
}
set
{
id = value;
}
}
public (bool, string, PayFrequency, double) Salary { get; set; }
}
When creating the property, it is a good idea, although not a requirement, to name the elements of the tuple. It may also be a good idea to add comments that explain the roles of the elements of the tuple. Here is an example:
public class Employee
{
private (int, string, bool) id;
/* An employee is identified with three pieces of information:
* the code is a type of employee number or contractor code,
* the name represents the full name. It could include the
* first name, the middle initial, and a last name.
* The last piece of information indicates whether the
* employee is part-time (false) or full-time (true). */
public (int code, string name, bool full_time) Identification
{
get
{
return id;
}
set
{
id = value;
}
}
}
As mentioned in the previous lesson, if you don't name the elements of a tuple, the compiler gives them some default names as Item1, Item2, etc.
When using the property, you may need to access the elements of its type. You will access them by their names. From inside the class, such as in the body of a clause of another property or in the body of a method of the same name, type the name of the desired property, type a period, and select the element of your choice. Here is an example:
When using the property outside the class, if you have declared a variable of the class that owns the property, type the name of the object, a period, the name of the property, a period, and the desired element. Here is an example:
Once you have accessed the property or any of its elements, you can use it like any property as we have done in previous lessons.
If you create an automatic tuple property, you cannot individually initialize the elements of the tuple property. Still, you can access the elements to present to the user. Here is an example:
using static System.Console; Processor proc = new(); public class Processor { /* We are combining these pieces of information of the * processor because processors specifications are * related by generation and tied to a manufacturer. */ public (string make, string model, string socket) Manufacture { get; set; } public (int, int) Count { get; set; } public double Speed { get; set; } public Processor() { Count = (6, 12); Manufacture = ("AMD", "RYZEN 5", "AM4"); Present(); } private void Present() { Write("Make: "); WriteLine(Manufacture.make); Write("Model: "); WriteLine(Manufacture.model); Write("Socket: "); WriteLine(Manufacture.socket); Write("Processor: "); Write(Count.Item1); Write("-Core, "); Write(Count.Item2); WriteLine("-Thread."); WriteLine("=============================="); } }
This would produce:
Make: AMD Model: RYZEN 5 Socket: AM4 Processor: 6-Core, 12-Thread. ============================== Press any key to continue . . .
Practical Learning: Introducing if...else Conditions
namespace PayrollPreparation6.Models
{
internal class TimeSheet
{
internal required int TimeSheetNumber { get; set; }
internal required int EmployeeNumber { get; set; }
internal required double Monday { get; set; }
internal required double Tuesday { get; set; }
internal required double Wednesday { get; set; }
internal required double Thursday { get; set; }
internal required double Friday { get; set; }
private double GetSalary()
{
if (EmployeeNumber == 370_595)
{
return 28.25;
}
else if (EmployeeNumber == 826_384)
{
return 24.37;
}
else if (EmployeeNumber == 175_004)
{
return 26.97;
}
else if (EmployeeNumber == 697_415)
{
return 31.57;
}
else
return 0.00;
}
internal double TimeWorked
{
get
{
return Monday + Tuesday + Wednesday + Thursday + Friday;
}
}
internal (double RegularTime, double RegularPay, double Overtime, double OvertimePay) PaySummary
{
get
{
double sal = GetSalary();
double regTime = TimeWorked;
double regPay = sal * TimeWorked;
double overtime = 0.00;
double overPay = 0.00;
if (TimeWorked is > 40.00)
{
regTime = 40.00;
regPay = sal * 40.00;
overtime = TimeWorked - 40.00;
overPay = sal * 1.50 * overtime;
}
return (regTime, regPay, overtime, overPay);
}
}
internal double GrossPay
{
get
{
(_, double regPay, _, double overPay) = PaySummary;
return regPay + overPay;
}
}
}
}
using PayrollPreparation6.Models; using static System.Console; PreparePayroll(); Employee Hire(in int number) { Employee empl1 = new Employee() { EmployeeNumber = 370_595, FirstName = "Michael", LastName = "Carlock", HourlySalary = 28.25 }; Employee empl2 = new Employee() { EmployeeNumber = 826_384, FirstName = "Catherine", LastName = "Busbey", HourlySalary = 24.37 }; Employee empl3 = new Employee() { EmployeeNumber = 175_004, FirstName = "Andrew", LastName = "Sanders", HourlySalary = 26.97 }; Employee empl4 = new Employee() { EmployeeNumber = 697_415, FirstName = "Jennifer", LastName = "Simms", HourlySalary = 31.57 }; if(number == 370_595) { return empl1; } else if (number == 826_384) { return empl2; } else if (number == 175_004) { return empl3; } else if (number == 697_415) { return empl4; } return new Employee() { EmployeeNumber = 0, FirstName = "John", LastName = "Doe", HourlySalary = 0.00 }; } TimeSheet GetTimeWorked(in int number) { TimeSheet ts1 = new TimeSheet() { TimeSheetNumber = 100_000, EmployeeNumber = 370_595, Monday = 7, Tuesday = 8, Wednesday = 6.5, Thursday = 8.5, Friday = 6.5 }; TimeSheet ts2 = new TimeSheet() { TimeSheetNumber = 205_000, EmployeeNumber = 826_384, Monday = 9.5, Tuesday = 8, Wednesday = 10.5, Thursday = 9, Friday = 8.5 }; TimeSheet ts3 = new TimeSheet() { TimeSheetNumber = 505_500, EmployeeNumber = 175_004, Monday = 9, Tuesday = 10.5, Wednesday = 7, Thursday = 9.5, Friday = 8.5 }; TimeSheet ts4 = new TimeSheet() { TimeSheetNumber = 202_240, EmployeeNumber = 697_415, Monday = 8, Tuesday = 8, Wednesday = 8, Thursday = 8, Friday = 8 }; if (number == 205_000) { return ts2; } else if (number == 202_240) { return ts4; } else if (number == 505_500) { return ts3; } else if (number == 100_000) { return ts1; } return new TimeSheet() { TimeSheetNumber = 0, EmployeeNumber = 0, Monday = 0.00, Tuesday = 0.00, Wednesday = 0.00, Thursday = 0.00, Friday = 0.00 }; } void PreparePayroll() { int nbr = 205_000; TimeSheet timeSheet = GetTimeWorked(nbr); Employee staff = Hire(timeSheet.EmployeeNumber); WriteLine("+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+"); WriteLine("FUN DEPARTMENT STORE"); WriteLine("======================================================="); WriteLine("Payroll Evaluation"); WriteLine("======================================================="); WriteLine("Employee Information"); WriteLine("-------------------------------------------------------"); WriteLine("Employee #: {0}", timeSheet.EmployeeNumber); WriteLine($"Full Name: {staff.FirstName} {staff.LastName}"); WriteLine($"Hourly Salary: {staff.HourlySalary:f}"); WriteLine("======================================================="); WriteLine("Time Worked Summary"); WriteLine("--------+---------+-----------+----------+-------------"); WriteLine(" Monday | Tuesday | Wednesday | Thursday | Friday"); WriteLine("--------+---------+-----------+----------+-------------"); Write($" {timeSheet.Monday:f} | "); Write($"{timeSheet.Tuesday:f} | "); Write($"{timeSheet.Wednesday:f} | "); Write($"{timeSheet.Thursday:f} | "); WriteLine($"{timeSheet.Friday:f}"); WriteLine("========+=========+===========+==========+============="); WriteLine(" Pay Summary"); WriteLine("-------------------------------------------------------"); WriteLine(" Time Pay"); WriteLine("-------------------------------------------------------"); Write($" Regular: {timeSheet.PaySummary.RegularTime:f} "); WriteLine($"{timeSheet.PaySummary.RegularPay:f}"); WriteLine("-------------------------------------------------------"); Write($" Overtime: {timeSheet.PaySummary.Overtime:f} "); WriteLine($"{timeSheet.PaySummary.OvertimePay:f}"); WriteLine("======================================================="); WriteLine($" Net Pay: {timeSheet.GrossPay:f}"); WriteLine("======================================================="); }
+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ FUN DEPARTMENT STORE ======================================================= Payroll Evaluation ======================================================= Employee Information ------------------------------------------------------- Employee #: 826384 Full Name: Catherine Busbey Hourly Salary: 24.37 ======================================================= Time Worked Summary --------+---------+-----------+----------+------------- Monday | Tuesday | Wednesday | Thursday | Friday --------+---------+-----------+----------+------------- 9.50 | 8.00 | 10.50 | 9.00 | 8.50 ========+=========+===========+==========+============= Pay Summary ------------------------------------------------------- Time Pay ------------------------------------------------------- Regular: 40.00 974.80 ------------------------------------------------------- Overtime: 5.50 201.05 ======================================================= Net Pay: 1175.85 ======================================================= Press any key to close this window . . .
Topics on Tuples
Methods and Tuples
We saw how to involve tuples with functions. Everything we saw about passing a tuple as argument and returning a tuple can be applied exactly the same way to the methods of a class. Normally, methods deal with tuples exactly as we described for functions, with just minor adjustments. It is important to remember (as stated in our introductory lesson on functions) that a function is a section of code that behaves as if it written outside of a class. Otherwise, everything we studied about involving tuples and functions also applies to methods. This means that you can pass a tuple to a method and you can return a tuple from a method.
As you know already, a method is a function created inside a class. As you know already, if you create a method, it has direct access to other members of the same class. In a method, you have direct access to the names of the tuples. To access an element of a tuple, type the name of the member, a period, and the desired member. That way, you can initialize a tuple. Here is an example:
public class Processor
{
/* We are combining these pieces of information of the
* processor because processors specifications are
* related by generation and tied to a manufacturer. */
private (string make, string model, string socket) identification;
private void Create()
{
identification = ("AMD", "RYZEN 5", "AM4");
}
}
An Object in a Tuple
All the elements we used so far in tuples were of regular types. In reality, each element is a placeholder for practically any type you want. Based on this, an element of a tuple can be an object of a structure or class type. Of course, you must have a class. You can create and use your own class. Here is an example of a class named Trapezoid created in a Windows Forms application named Geometry:
namespace Geometry { public class Trapezoid { public double TopBase { get; set; } public double BottomBase { get; set; } public double Height { get; set; } public double Area { get { return Height * (TopBase + BottomBase) / 2.00; } } } }
When creating the tuple, specify the desired element using the name of the class. Here is an example:
Trapezoid isosceles = new Circle(); (Trapezoid shape, int value) definition; public class Trapezoid { public double TopBase { get; set; } public double BottomBase { get; set; } public double Height { get; set; } public double Area { get { return Height * (TopBase + BottomBase) / 2.00; } } }
When initializing the tuple or when specifying its value, you must define the object used as element. You have various options:
using static System.Console; Trapezoid trap = new Trapezoid(); trap.TopBase = 244.86; trap.BottomBase = 384.92; trap.Height = 175.74; string msg = null; (Trapezoid figure, string) shape = (trap, msg); WriteLine("Area: {0}", shape.figure.Area); public class Trapezoid { public double TopBase { get; set; } public double BottomBase { get; set; } public double Height { get; set; } public double Area { get { return Height * (TopBase + BottomBase) / 2.00; } } }This would produce:
Area: 55338.7686 Press any key to close this window . . .To access a member of the class, such as its property or methof, type the name of the tuple, a period, the name you gave to the element or the item_x default name, a period, and the name of the class member. Here is an example
using static System.Console; Trapezoid trap = new Trapezoid(); trap.TopBase = 244.86; trap.BottomBase = 384.92; trap.Height = 175.74; string msg = "An isosceles trapezoid is a quadrilateral with two opposing sidesl."; (Trapezoid figure, string description) shape = (trap, msg); WriteLine("Area: {0}", shape.figure.Area); public class Trapezoid { public double TopBase { get; set; } public double BottomBase { get; set; } public double Height { get; set; } public double Area { get { return Height * (TopBase + BottomBase) / 2.00; } } }
using static System.Console;
string msg = "An isosceles trapezoid is a quadrilateral with two opposing sidesl.";
Write("Top Base: ");
double tb = double.Parse(ReadLine());
Write("Bottom Base: ");
double bb = double.Parse(ReadLine());
Write("Height: ");
double height = double.Parse(ReadLine());
(Trapezoid figure, string description) shape = (new Trapezoid()
{
TopBase = tb,
BottomBase = bb,
Height = height
}, msg);
WriteLine("-------------------------");
WriteLine("Area: {0}", shape.figure.Area);
WriteLine("=========================");
public class Trapezoid
{
public double TopBase { get; set; }
public double BottomBase { get; set; }
public double Height { get; set; }
public double Area
{
get
{
return Height * (TopBase + BottomBase) / 2.00;
}
}
}
Here is an example of running the program:
Top Base: 228.97 Bottom Base: 406.66 Height: 214.83 ------------------------- Area: 68276.19645 ========================= Press any key to close this window . . .
using static System.Console; Trapezoid Create() { Trapezoid holder = new Trapezoid(); Write("Top Base: "); double tb = double.Parse(ReadLine()); Write("Bottom Base: "); double bb = double.Parse(ReadLine()); Write("Height: "); double height = double.Parse(ReadLine()); holder.TopBase = tb; holder.BottomBase = bb; holder.Height = height; return holder; } string msg = "An isosceles trapezoid is a quadrilateral with two opposing sidesl."; (Trapezoid figure, string description) shape = (Create(), msg); WriteLine("-------------------------"); WriteLine("Area: {0}", shape.figure.Area); WriteLine("========================="); public class Trapezoid { public double TopBase { get; set; } public double BottomBase { get; set; } public double Height { get; set; } public double Area { get { return Height * (TopBase + BottomBase) / 2.00; } } }Here is an example of running the program:
Top Base: 228.68 Bottom Base: 369.37 Height: 273.69 ------------------------- Area: 81840.15225 ========================= Press any key to close this window . . .
In the above example, we used a tuple that has one element that is a class type. In the same way, you can create a tuple with more than one element that are of class or structure type. The elements can be of the same class (or structure) or different classes (or structures).
In the above example, we used our own class. On the other hand, we know that the .NET Framework provides a large collection of classes and structures. You can use any of most of the many classes of the .NET Framework for an element of a tuple.
The Name Involving a Tuple
We already know that, to help you identify something in your code, the C# language provides an operator named nameof. You can use this property on anything that involves a tuple, including a variable of a tuple type, a property of a tuple type, a function or method that returns a tuple, or a function or property that takes a tuple as argument. Here are examples:
using static System.Console; (int nbr, string status, double salary) employee = (937_842, "Full Time", 22.48); (string fname, string lname) Identify() { return ("Frank", "Lanson"); } House house = new House() { PropertyNumber = 938_448, Rooms = (5, 3.5), MarketValue = 545_760 }; void Present(int nbr, (string title, House prop) listing) { WriteLine(listing.title); WriteLine("----------------------------------"); WriteLine("Listing #: {0}", nbr); WriteLine("Property #: {0}", listing.prop.PropertyNumber); WriteLine("Bedrooms: {0}", listing.prop.Rooms.beds); WriteLine("Bathrooms: {0}", listing.prop.Rooms.baths); WriteLine("Market Value: {0}", listing.prop.MarketValue); } WriteLine("Employee Record"); WriteLine("----------------------------------"); WriteLine("Employee #: {0}", employee.nbr); WriteLine("Employee Name: {0} {1}", Identify().fname, Identify().lname); WriteLine("Employment Status: {0}", employee.status); WriteLine("Hourly Salary: {0}", employee.salary); WriteLine("=================================="); Present(1001, ("Property Listing", house)); WriteLine("=================================="); WriteLine("Name of Tuple Variable: {0}", nameof(employee)); WriteLine("Name of Tuple Function: {0}", nameof(Identify)); WriteLine("Name of Object: {0}", nameof(house)); WriteLine("Name of Tuple Property: {0}", nameof(house.Rooms)); WriteLine("Name of Function: {0}", nameof(Present)); WriteLine("=================================="); internal class House { public int PropertyNumber { get; set; } public (int beds, double baths) Rooms { get; set; } public double MarketValue { get; set; } }
This would produce:
Employee Record ---------------------------------- Employee #: 937842 Employee Name: Frank Lanson Employment Status: Full Time Hourly Salary: 22.48 ================================== Property Listing ---------------------------------- Listing #: 1001 Property #: 938448 Bedrooms: 5 Bathrooms: 3.5 Market Value: 545760 ================================== Name of Tuple Variable: employee Name of Tuple Function: Identify Name of Object: house Name of Tuple Property: Rooms Name of Function: Present ================================== Press any key to close this window . . .
Practical Learning: Ending the Lesson
|
|||
Previous | Copyright © 2001-2024, FunctionX | Saturday 29 April 2023, 22:44 | Next |
|