Why Record structs in C Sharp (C#)? - Purpose & Use Cases

The Big Idea

What if you could write less code and still get perfect data comparisons and copies automatically?

The Scenario

Imagine you want to store simple data like a point with X and Y coordinates. You write a struct with fields, constructors, and methods to compare points. But every time you want to copy or compare points, you write extra code. It feels like repeating the same work over and over.

The Problem

Manually writing structs for simple data is slow and error-prone. You might forget to write equality checks or GetHashCode methods. This leads to bugs and messy code.

The Solution

Record structs provide a neat way to define simple data containers with built-in value equality and copying. They combine the speed of structs with the convenience of records, so you write less code and get safer, clearer data types.

Before vs After

✗ Before

public struct Point {
  public int X, Y;
  public Point(int x, int y) { X = x; Y = y; }
  public override bool Equals(object obj) { /* manual equality code */ return base.Equals(obj); }
  public override int GetHashCode() { /* manual hash code */ return base.GetHashCode(); }
}

✓ After

public record struct Point(int X, int Y);

What It Enables

You can create simple, efficient data types that automatically support comparison, copying, and immutability with minimal code.

Real Life Example

In a game, you can represent positions or colors as record structs. This makes it easy to compare locations or colors without writing extra code, improving performance and reducing bugs.

Key Takeaways

Manual data types require extra code for equality and hashing.

Record structs simplify this by combining struct speed with record features.

This leads to cleaner, safer, and more efficient code.

Practice

1. What is a key feature of record struct in C#?

easy

A. It provides value-based equality and immutability by default.

B. It allows inheritance from other structs.

C. It can only be used for reference types.

D. It does not support property declarations.

Solution

1. Step 1: Understand record struct purpose

   Record structs combine struct's lightweight nature with record's value-based equality and immutability.

2. Step 2: Analyze options

   It provides value-based equality and immutability by default. correctly states value-based equality and immutability. Options B, C, and D are incorrect because structs cannot inherit, record structs are value types, and they support properties.

3. Final Answer:

   It provides value-based equality and immutability by default. -> Option A

4. Quick Check:

   record struct = value equality + immutability [OK]

Hint: Remember: record structs behave like immutable value containers [OK]

Common Mistakes:

• Thinking record structs support inheritance
• Confusing record structs with classes
• Assuming record structs are reference types

2. Which of the following is the correct syntax to declare a record struct named Point with two properties X and Y of type int?

easy

A. struct record Point { int X; int Y; }

B. record Point struct { int X; int Y; }

C. record struct Point(int X, int Y);

D. record struct Point { int X; int Y; }

Solution

1. Step 1: Recall record struct declaration syntax

   The concise syntax for record structs uses positional parameters: record struct Name(type prop1, type prop2);

2. Step 2: Compare options

   record struct Point(int X, int Y); matches the correct syntax. record struct Point { int X; int Y; } is close but missing parentheses for positional parameters. Options A and C have incorrect order or keywords.

3. Final Answer:

   record struct Point(int X, int Y); -> Option C

4. Quick Check:

   record struct with positional params = record struct Point(int X, int Y); [OK]

Hint: Use parentheses for positional properties in record structs [OK]

Common Mistakes:

• Swapping 'record' and 'struct' keywords
• Omitting parentheses for positional parameters
• Using braces instead of parentheses for positional syntax

3. What will be the output of the following code?

record struct Point(int X, int Y);
var p1 = new Point(3, 4);
var p2 = new Point(3, 4);
Console.WriteLine(p1 == p2);

medium

A. True

B. False

C. Compilation error

D. Runtime exception

Solution

1. Step 1: Understand equality in record structs

   Record structs provide value-based equality by default, so two instances with same values are equal.

2. Step 2: Analyze the code output

   Both p1 and p2 have X=3 and Y=4, so p1 == p2 evaluates to true.

3. Final Answer:

   True -> Option A

4. Quick Check:

   record struct equality = value equality [OK]

Hint: Record structs compare values, not references [OK]

Common Mistakes:

• Assuming == compares references for structs
• Expecting compilation error for == operator
• Confusing record structs with classes for equality

4. Identify the error in this code snippet:

record struct Rectangle(int Width, int Height);
var rect = new Rectangle(5, 10);
rect.Width = 7;
Console.WriteLine(rect);

medium

A. Rectangle must be a class to allow property assignment.

B. Missing semicolon after record struct declaration.

C. Console.WriteLine cannot print record structs.

D. Cannot assign to 'Width' because it is readonly.

Solution

1. Step 1: Understand immutability of record structs

   Record structs with positional parameters generate readonly properties by default.

2. Step 2: Analyze the assignment line

   Trying to assign rect.Width = 7; causes a compile-time error because Width is readonly.

3. Final Answer:

   Cannot assign to 'Width' because it is readonly. -> Option D

4. Quick Check:

   Positional record struct properties are readonly [OK]

Hint: Positional record struct properties are readonly by default [OK]

Common Mistakes:

• Trying to modify readonly properties
• Confusing record structs with mutable classes
• Ignoring compiler error messages

5. You want to create a lightweight data type to store a 3D point with coordinates X, Y, and Z. You want it to be immutable, support value equality, and print nicely. Which is the best way to declare it using record structs?

hard

A. struct Point3D { public int X; public int Y; public int Z; }

B. record struct Point3D(int X, int Y, int Z);

C. class Point3D { public int X { get; set; } public int Y { get; set; } public int Z { get; set; } }

D. record class Point3D(int X, int Y, int Z);

Solution

1. Step 1: Identify requirements

   Needs lightweight, immutable, value equality, and nice printing.

2. Step 2: Match requirements to options

   record struct Point3D(int X, int Y, int Z); uses record struct with positional parameters, providing all requirements. struct Point3D { public int X; public int Y; public int Z; } is mutable struct without value equality or nice printing. class Point3D { public int X { get; set; } public int Y { get; set; } public int Z { get; set; } } is mutable class, heavier and reference type. record class Point3D(int X, int Y, int Z); is record class, reference type, not lightweight.

3. Final Answer:

   record struct Point3D(int X, int Y, int Z); -> Option B

4. Quick Check:

   record struct = lightweight + immutable + value equality [OK]

Hint: Use record struct with positional params for immutable lightweight data [OK]

Common Mistakes:

• Choosing class instead of struct for lightweight data
• Using mutable fields instead of readonly properties
• Confusing record class with record struct