TsadriuUtilities 1.1.1

TsadriuUtilities

A small package with utilities to save a little bit of time in coding.

TsadriuUtilities is a library that helps on dealing with

• Arrays, Chars, Date and Time, Directories, Files, Lists, Numbers, Strings and Generic types, to hopefully make coding easier while also saving a bit of time.

> Features <

ArrayHelper:

• ToString<T>(T[], string):
  • Converts an Array into a single line of string. If the separator is not passed, it will separate by a space. Examples: ArrayToString(new int[] { 1, 3, 5 }) → "1 3 5", ArrayToString(new string[] { "5", "2" }, "|") → "5|2".
• GenerateRandom<T>(T[] array, int min = 0, int max = 100):
  • Fills up the array with random numbers between min (default: 0, inclusive) and max (default: 100, inclusive).

CharHelper:

• ToChar(string value, int index):
  • Converts an string into a char. If the length of value is higher than 1, it will return the first character of value or, if index is passed, the character of the desired index.

DateTimeHelper:

• ToDateTime(string dateAsString, string dateFormat, CultureInfo cultureInfo):
• ToDateTime(string dateAsString, string[] dateFormats, CultureInfo cultureInfo):
  • Tries to convert a date from a string to a type of DateTime.
• GetLastDayOfMonth(DateTime date):
  • Parses the date to return with the last day of the month.
• SetDay(DateTime date, int day):
  • Sets the day in the date. In case the day is higher than the month's max days, it will be clamped.
• SetMonth(DateTime date, int month):
  • Sets the month in the date. In case the month is higher than the year's maximum months, it will be clamped.
• SetYear(DateTime date, int year):
  • Sets the year in the date.

DirectoryHelper:

• Exist(string path, bool createFolder):
  • Checks if a path exists. If createFolder is true, it will create the path if it doesn't exist.
• NotExist(string path, bool createFolder):
  • Checks if a path does not exist. If createFolder is true, it will create the path if it doesn't exist.

FileHelper:

• GetFileExtention(string fileName):
  • Returns the extention of a file name. If the file name multiple extentions (Example: filename.txt.zip), it will return the last extention.
• Exist(string fullFileName, bool createFile):
  • Checks if a file exists. If createFile is true, it will create the file if it doesn't exist (Keep in mind that the path of the full file name must exist for createFile to work).
• NotExist(string fullFileName, bool createFile):
  • Checks if a file does not exist. If createFile is true, it will create the file if it doesn't exist (Keep in mind that the path of the full file name must exist for createFile to work).

ListHelper:

• AddRange<T>(List<T> list, T[] array, int startIndex, int endIndex):
  • Adds the array into the list. If statIndex is specified, it will add the contents of the array only from startIndex (included) until the end of the array or until it reaches endIndex (included) if it is specified.
• AddRange<T>(List<T> list, List<T> listToAdd, int index):
  • Adds the listToAdd into the list. If index is specified, it will add the contents of the listToAdd only from index (included) until the end of the list.
• ToList<T>(T[] array):
  • Transforms an array into a List<T>.
• OrderByAscending(List<T> list):
  • Orders a list in ascending order.
• OrderByDescending<T>(List<T> list):
  • Orders a list in descending order.
• ToString<T>(List<T> list, string separator, int startIndex, int count)
  • /// Converts an list into a single line of string. If separator is not passed, it will separate by a space. Examples: ListToString(new int[] { 1, 3, 5 }) → "1 3 5", ListToString(new string[] { "5", "2" }, "|") → "5|2".
• HasAny<T>(List<T> list)
  • Iterates through the list, checking that it has at least 1 non null element.

MultiHelper:

• ClampValue<T>(T currentValue, T minValue, T maxValue):
  • Clamps a value based on its' parameters. Returns maxValue if currentValue is higher than it and returns minValue if it is lower than it.

NumberHelper:

• ToDecimal(string value):
  • Converts a string into a decimal. If the conversion fails, returns a 0.0M.
• ToDouble(string value):
  • Converts a string into a double. If the conversion fails, returns a 0.0d.
• Max<T>(T[] sequence):
  • Returns the highest number present in the sequence.
• Min<T>(T[] sequence):
  • Returns the lowest number present in the sequence.
• Between<T>(T value, T min, T max, bool included):
  • Check if the value is between min and max. Setting included to true will also include min and max in the verification.

StringHelper:

• GetTagValue(string text, string startTag, string endTag, bool tagsIncluded):
  • Searches through the text, returning the first instance found between the startTag and endTag. Use tagsIncluded if you want to include them.
• GetTagValues(string text, string startTag, string endTag, bool tagsIncluded):
  • Searches through the text, returning all instances found between the startTag and endTag. Use tagsIncluded if you want to include them.
• IsEmpty(string value):
  • Checks if the value is null, string.Empty or a white space ("", " ", "\n", "\r", ...)
• IsNotEmpty(string value):
  • Check if the value contains any kind of character.
• AreEmpty(string[] values):
  • Checks if all instances of values are null, string.Empty or a white space ("", " ", "\n", "\r", ...)
• AreNotEmpty(string[] values):
  • Checks if all instances of values contain any kind of character.
• LetterUpperCase(string value, int index):
  • Changes a lower-case letter to be upper-case. If index is not passed, it will change the first letter of value.
• LetterLowerCase(string value, int index):
  • Changes a upper-case letter to be lower-case. If index is not passed, it will change the first letter of value.
• Remove(string value, params string[] valuesToRemove):
  • Returns a string where all instances of valuesToRemove have been removed from the value.
• CharCount(string value, string valueToCount)
  • Returns the count of valueToCount present in the value.
• RemoveTags(string value, tag)
• RemoveTags(string value, string[] tags)
  • Returns a string where all instances of tags are removed (tag b will remove <b>, </b> and <b/>.

TTable:

• AddColumn(params string[] columnName):
• AddColumn(params TTable[] columnName):
  • Adds a new TTableColumn in the TTable.
• AddData(string columnName, params object[] values):
• AddData(TTableColumn tableColumn, params object[] values):
  • Adds values into the TTableColumn as object.
• ExistsData(string columnName, object value):
• ExistsData(TTableColumn tableColumn, object value):
  • Checks through the TTableColumn for value. Returns true if value is found, otherwise false.
• GetData(string columnName):
  • If the columnName exists, returns all the data present in the TTableColumn.
• RemoveData(string columnName, params object[] valuesToRemove):
• RemoveData(TTableColumn tableColumn, params object[] valuesToRemove):
  • Removes all instances of valuesToRemove.
• TableToCsv(bool addHeader, string separator):
  • Transform the TTable into a parseable .csv file.
• CsvToTable(string fullFileName, string separator):
  • Transform a .csv file into a TTable.

TTableColumn:

• string ColumnName { get; set; }:
  • Gets or sets the name of the column.
• List<object> ColumnData { get; set; }:
  • Gets or sets the data in the column.
• AddData(params object[] values):
  • Adds the values in the ColumnData as object.
• ExistData(params object[] values):
  • Checks through the ColumnData for value. Returns true if value is found, otherwise false.
• RemoveData(params object[] values):
  • Removes all instances of values.