AINStringUtils - библиотека для .NET для работы со строками

User Rating: 5 / 5

Доброго времени суток, друзья. 

Сегодня мы выпустили релиз нашей библиотеки AINStringUtils и с радостью хотим представить его вам. AINStringUtils - это библиотека функций для работы со строками для .NET Framework. Вы можете использовать её в своих программах для .NET Framework, когда вам требуются дополнительные возможности при работе со строками.

Библиотека функций представлена в формате DLL-библиотеки и содержит пространство имён AINStringUtils с классом AINStringExtensions.

Данный класс содержит ряд полезных extension-методов и статический метод IsStringNullOrEmpty, которые вы можете с лёгкостью подключать к своим программам для .NET, независимо от языка программирования, который вы используете для написания своих программ под эту платформу. Это может быть, например, язык C# или Visual Basic, всё на ваш вкус.

Библиотека AINStringUtils также поставляется вместе с документацией на содержащиеся в ней методы. Также каждый метод задокументирован, что облегчит ваш пользовательский опыт при работе с библиотекой в среде разработки.

Где скачать библиотеку AINStringUtils?

Библиотеку AINStringUtils можно скачать на нашем сайте в разделе Наши продукты.

Она находится в разделе Allineed.Ru Библиотеки классов для .NET.

Ссылка для скачивания текущей актуальной версии 1.0.0.0 находится здесь.

Где скачать документацию на библиотеку?

Документацию на библиотеку AINStringUtils вы можете также скачать в разделе Allineed.Ru Библиотеки классов для .NET

Ссылка для скачивания документации находится здесь.

Как подключить библиотеку AINStringUtils к вашим программам и проектам в среде Microsoft Visual Studio?

Для подключения библиотеки AINStringUtils к вашим программам вам необходимо добавить ссылку на библиотеку, а также прописать необходимые директивы для импорта пространства имён AINStringUtils и класса AINStringExtensions.

Шаг 1. Скачайте библиотеку AINStringUtils с нашего сайта

Шаг 2. Разместите скачанный файл библиотеки AINStringUtils.dll рядом с файлами вашего проекта для среды Microsoft Visual Studio

Шаг 3. В окне "Обозреватель решений" для вашего проекта кликните правой кнопкой мыши на элементе "Ссылки" и выберите пункт "Добавить ссылку..."

Шаг 4. В окне "Менеджер ссылок" слева выберите раздел "Обзор" и нажмите внизу диалогового окна кнопку "Обзор...", затем найдите местоположение файла AINStringUtils.dll в том каталоге, куда вы поместили его в шаге 2 и выберите файл. После этого вы увидите добавленную библиотеки и путь к ней. Убедитесь, что напротив библиотеки установлен флажок:

Шаг 5. Пропишите директивы в верхней части ваших классов C# и форм Visual Basic, где нужно использовать методы библиотеки.

C#:

using static AINStringUtils.AINStringExtensions;

Visual Basic:

Imports AINStringUtils.AINStringExtensions

Шаг 6. Теперь вам доступны методы, входящие в библиотеку

C#:

private void UpdateTextBoxResults() {
	string input;
	string results = "";

	input = TextBoxTestString.Text;

	char[] specialChars = {'^', '%', '$' };

	results += "Входная строка == null или пустая?: " + (IsStringNullOrEmpty(input) ? "Да" : "Нет") + "\r\n";
	results += "Количество согласных: " + input.GetConsonantsCount() + "\r\n";
	results += "Количество гласных: " + input.GetVowelsCount() + "\r\n";
	results += "Количество whitespace-символов: " + input.GetWhiteSpacesCount() + "\r\n";
	results += "Количество цифровых символов: " + input.GetDigitsCount() + "\r\n";
	results += "Содержит только цифры?: " + (input.ContainsOnlyDigits() ? "Да" : "Нет") + "\r\n";
	results += "Содержит только буквы?: " + (input.ContainsOnlyLetters() ? "Да" : "Нет") + "\r\n";
	results += "Содержит только whitespace-символы?: " + (input.ContainsOnlyWhiteSpace() ? "Да" : "Нет") + "\r\n";
	results += "Содержит спецсимволы?: " + (input.ContainsSpecialSymbols() ? "Да" : "Нет") + "\r\n";
	results += "Содержит указанные спецсимволы? (^ % $): " + (input.ContainsSpecialSymbols(specialChars) ? "Да" : "Нет") + "\r\n";
	results += "Является палиндромом?: " + (input.IsPalindrome() ? "Да" : "Нет") + "\r\n";
	results += "Является пустой строкой?: " + (input.IsEmpty() ? "Да" : "Нет") + "\r\n";
	results += "Не является пустой строкой?: " + (input.IsNotEmpty() ? "Да" : "Нет") + "\r\n";
	results += "Длина равна 5?: " + (input.LengthEquals(5) ? "Да" : "Нет") + "\r\n";
	results += "Длина является чётной?: " + (input.LengthIsEven() ? "Да" : "Нет") + "\r\n";
	results += "Длина является нечётной?: " + (input.LengthIsOdd() ? "Да" : "Нет") + "\r\n";
	results += "Длина от 5 до 10?: " + (input.LengthBetween(5, 10) ? "Да" : "Нет") + "\r\n";
	results += "Заканчивается новой строкой?: " + (input.EndsWithNewLine() ? "Да" : "Нет") + "\r\n";
	results += "Заканчивается символами возврата каретки и перевода на новую строку?: " + (input.EndsWithCrLf() ? "Да" : "Нет") + "\r\n";
	results += "Заканчивается цифрой?: " + (input.EndsWithDigit() ? "Да" : "Нет") + "\r\n";
	results += "Перевёрнутая строка: " + input.GetReversed() + "\r\n";

	TextBoxResults.Text = results;
}

Visual Basic:

Private Sub UpdateTextBoxResults()
	Dim input As String
	Dim results As String = ""

	input = TextBoxTestString.Text

	Dim specialChars() As Char = {"^", "%", "$"}

	results &= "Входная строка == null или пустая?: " & IIf(IsStringNullOrEmpty(input), "Да", "Нет") & vbCrLf
	results &= "Количество согласных: " & input.GetConsonantsCount & vbCrLf
	results &= "Количество гласных: " & input.GetVowelsCount & vbCrLf
	results &= "Количество whitespace-символов: " & input.GetWhiteSpacesCount & vbCrLf
	results &= "Количество цифровых символов: " & input.GetDigitsCount & vbCrLf
	results &= "Содержит только цифры?: " & IIf(input.ContainsOnlyDigits, "Да", "Нет") & vbCrLf
	results &= "Содержит только буквы?: " & IIf(input.ContainsOnlyLetters, "Да", "Нет") & vbCrLf
	results &= "Содержит только whitespace-символы?: " & IIf(input.ContainsOnlyWhiteSpace, "Да", "Нет") & vbCrLf
	results &= "Содержит спецсимволы?: " & IIf(input.ContainsSpecialSymbols, "Да", "Нет") & vbCrLf
	results &= "Содержит указанные спецсимволы? (^ % $): " & IIf(input.ContainsSpecialSymbols(specialChars), "Да", "Нет") & vbCrLf
	results &= "Является палиндромом?: " & IIf(input.IsPalindrome, "Да", "Нет") & vbCrLf
	results &= "Является пустой строкой?: " & IIf(input.IsEmpty, "Да", "Нет") & vbCrLf
	results &= "Не является пустой строкой?: " & IIf(input.IsNotEmpty, "Да", "Нет") & vbCrLf
	results &= "Длина равна 5?: " & IIf(input.LengthEquals(5), "Да", "Нет") & vbCrLf
	results &= "Длина является чётной?: " & IIf(input.LengthIsEven, "Да", "Нет") & vbCrLf
	results &= "Длина является нечётной?: " & IIf(input.LengthIsOdd, "Да", "Нет") & vbCrLf
	results &= "Длина от 5 до 10?: " & IIf(input.LengthBetween(5, 10), "Да", "Нет") & vbCrLf
	results &= "Заканчивается новой строкой?: " & IIf(input.EndsWithNewLine, "Да", "Нет") & vbCrLf
	results &= "Заканчивается символами возврата каретки и перевода на новую строку?: " & IIf(input.EndsWithCrLf, "Да", "Нет") & vbCrLf
	results &= "Заканчивается цифрой?: " & IIf(input.EndsWithDigit, "Да", "Нет") & vbCrLf
	results &= "Перевёрнутая строка: " & input.GetReversed & vbCrLf

	TextBoxResults.Text = results
End Sub

Какие extension-методы содержатся в классе AINStringExtensions библиотеки?

На текущий момент в версию 1.0.0.0 библиотеки добавлены следующие extension-методы

  • ContainsOnlyDigits - extension-метод проверяет, содержит ли строка только цифры. Если строка содержит пробелы или whitespace-символы, то результат функции false
  • ContainsOnlyLetters - extension-метод проверяет, содержит ли строка только буквы. Учитываются латинские и кириллические буквы алфавита. Если строка содержит пробелы или whitespace-символы, то результат функции false
  • ContainsOnlyWhiteSpace - extension-метод проверяет, содержит ли строка только whitespace-символы
  • ContainsSpecialSymbols(String) - extension-метод проверяет, что строка содержит как минимум один спецсимвол. К спецсимволам относятся следующие символы: . , | { } [ ] # ! @ $ % ^ & * ( ) + - = _ " : ' ` ? / ; > < ~
  • ContainsSpecialSymbols(String, Char[]) - extension-метод проверяет, что строка содержит как минимум один спецсимвол, который содержится в массиве specialSymbols
  • EndsWithCrLf - extension-метод проверяет, заканчивается ли строка на символы возврата каретки и перевода на новую строку rn
  • EndsWithDigit - extension-метод возвращает true, если строка заканчивается на одну или несколько цифр, например: "abc1", "абв 55", "123", "abc rn 4"
  • EndsWithNewLine - extension-метод проверяет, заканчивается ли строка на символ перевода на новую строку n
  • GetConsonantsCount - extension-метод подсчитывает количество согласных во входной строке. Учитываются латинские и кириллические буквы алфавита
  • GetDigitsCount - extension-метод подсчитывает количество символов, представляющих собой цифры, во входной строке. Учитываются цифры от 0 до 9
  • GetReversed - extension-метод возвращает инвертированную строку
  • GetSpacesCount - extension-метод подсчитывает количество пробелов во входной строке. Если строка пустая, возвращает 0
  • GetVowelsCount - extension-метод подсчитывает количество гласных во входной строке. Учитываются латинские и кириллические буквы алфавита, регистр символов не имеет значения
  • GetWhiteSpacesCount - extension-метод подсчитывает количество whitespace-символов во входной строке. Учитываются пробелы и следующие escape-последовательности: r, t, n, v, f, x85
  • IsEmpty - extension-метод проверяет, пуста ли строка
  • IsNotEmpty - extension-метод проверяет, что строка является непустой, т.е. её длина больше 0
  • IsPalindrome - extension-метод возвращает true, если строка является палиндромом. Пустая строка считается также палиндромом. Палиндром - это строка, читающаяся одинаково в обоих направлениях, например: "abcba", "абвба", "1234321", "!#%#!" и т.д.
  • IsStringNullOrEmpty - публичный статический метод возвращает true, если входная строка равна null или её длина равна 0
  • LengthBetween - extension-метод проверяет, что длина строки находится в заданном диапазоне от minLengthInclusive до maxLengthInclusive
  • LengthEquals - extension-метод возвращает true, если длина строки в точности совпадает с входным аргументом expectedLength
  • LengthIsEven - extension-метод возвращает true, если длина строки является чётной
  • LengthIsOdd - extension-метод возвращает true, если длина строки является нечётной

Готовые примеры демо-проектов для Visual Basic и C# с использованием библиотеки AINStringUtils

Мы подготовили демонстрационные проекты для среды Microsoft Visual Studio, чтобы вы могли посмотреть на живые примеры использования методов, входящих в библиотеку. Они доступны для скачивания ниже:

Демонстрационный проект для C# (Windows Forms)

Демонстрационный проект для Visual Basic

Яндекс.Метрика