CSharpExtensions

Useful extensions for C#.

String extensions

EqualsNullSafe

Null safe string comparison

const string str1 = "123";
const string str2 = "123";
const string str3 = "abc";
const string strNull = null;

str1.EqualsNullSafe(str1); // true
str1.EqualsNullSafe(str2); // true
str1.EqualsNullSafe(str3); // false

str1.EqualsNullSafe(strNull);     // false
strNull.EqualsNullSafe(str1);     // false
strNull.EqualsNullSafe(strNull);  // true

EqualsAbbreviations

strA.EqualsInv(strB)    // Invariant Culture (Null safe)
strA.EqualsInvIC(strB)  // Invariant Culture, Ignore case (Null safe)

strA.EqualsOrd(strB)    // Ordinal Culture (Null safe)
strA.EqualsOrdIC(strB)  // Ordinal Culture, Ignore case (Null safe)

SafeSubstring()

Substring with range checking.

string s = "12345".SafeSubstring(0,3);   // s is "123"
string s = "12345".SafeSubstring(0,10);  // s is "12345"

string s = "12345".SafeSubstring(3);     // s is "45"
string s = "12345".SafeSubstring(3, 5);  // s is "45"

string s = "12345".SafeSubstring(10);    // s is ""

Right() / Left()

string s = "12345".Left(3);   // s is "123"
string s = "12345".Right(2);  // s is "45"

string s = "12345".Left(10);  // s is "12345"
string s = "12345".Right(10); // s is "12345"

SplitAndTrim()

string s = "0 , 1 ,    2 , 3 ,4 ".sample.SplitAndTrim(new char[] {','}); 
// s is ["0","1","2","3","4"]

String Parsers

Parsing operations that converts a string that represents a .NET Framework base type into that base type.

Example:

int num = "123".ParseToInt(); // num is 123

int num = "ABC".ParseToInt(); // FormatException!!

int num = "ABC".ParseToIntOrDefault(); // int = 0

int num = "ABC".ParseToIntOrDefault(-1); // int = -1

Methods:

• ParseToInt()
• ParseToIntOrDefault([defaultValue])
• ParseToShort()
• ParseToShortOrDefault([defaultValue])
• ParseToLong()
• ParseToLongOrDefault([defaultValue])
• ParseToDecimal()
• ParseToDecimalOrDefault([defaultValue])
• ParseToDouble()
• ParseToDoubleOrDefault([defaultValue])

Collection extensions

IsNullOrEmpty()

Indicates whether the specified enumerable is null or empty.

readonly List<int> _nullList = null;
readonly List<int> _emptyList = new List<int>();
readonly List<int> _list = new List<int> { 1, 2, 3 };

_list.IsNullOrEmpty();         // false
_emptyList.IsNullOrEmpty();    // true
_nullList.IsNullOrEmpty();     // true

FirstIndex()

Finds the index of the first item matching an expression (-1 not found).

readonly List<int> _nullList = null;
readonly List<int> _emptyList = new List<int>();
readonly List<int> _list = new List<int> { 1, 2, 3 };

_nullList.FirstIndex(x => x == 3));   // result is -1
_emptyList.FirstIndex(x => x == 3));  // result is -1
_list.FirstIndex(x => x == 1));       // result is 0
_list.FirstIndex(x => x == 2));       // result is 1
_list.FirstIndex(x => x == 3));       // result is 2
_list.FirstIndex(x => x == 4));       // result is -1

Round Extensions

MRound()

Returns a number rounded to the desired multiple.

0.80.MRound(.25);   // Result = 0.75
0.80M.MRound(.05M); // Result = 0.80
0.255.MRound(.25);  // Result = 0.25

TestRoundAwayFromZero()

Rounds a decimal value to the nearest integer. When a number is halfway between two others, it is rounded toward the nearest number that is away from zero.

1.5.RoundAwayFromZero();  // Result = 2
2.5.RoundAwayFromZero();  // Result = 3
3.5.RoundAwayFromZero();  // Result = 4

####RoundToEven() Rounds a decimal value to the nearest integer. When a number is halfway between two others, it is rounded toward the nearest even number.

1.5.RoundToEven();  // Result = 2
2.5.RoundToEven();  // Result = 2
3.5.RoundToEven();  // Result = 4

System.Data

DbDataReader Extensions

Get value from dataReader or a default value if database field is null.

some examples:

using (DbDataReader dr = cmd.ExecuteReader()) {

	dr.ReadIntOrDefault(0); // returns dr[0] value as int or 0 if it's null
	
	dr.ReadStringOrDefault("COLUMN1"); // returns dr["COLUMN1"] value as string or null if it's null
	
	dr.ReadStringOrEmpty("COLUMN2"); // returns dr["COLUMN2"] value as string or "" if it's null
	
	dr.ReadShortOrDefault(3 ,-1); // returns dr[3] value as short or -1 if it's null

	dr.ReadLongOrDefault(4); // returns dr[4] value as long or 0 if it's null

	dr.ReadDateTimeOrDefault(5); // returns dr[5] value as DateTime or DateTime.MinValue if it's null

	dr.ReadDoubleOrDefault(6; // returns dr[6] field value as double or 0 if it's null

	dr.ReadDecimalOrDefault(7); // returns dr[7] field value as decimal or 0 if it's null
}