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

НА ЗАМЕТКУ

Данная статья является новостью по выпуску самой первой версии библиотеки AINStringUtils. В настоящее время актуальной версией библиотеки является AINStringUtils 2.0.0.0. Обе версии библиотеки вы сможете найти в разделе сайта "Наши продукты", в категории "Allineed.Ru Библиотеки классов для .NET"

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

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

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

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

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

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

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

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

Обновление статьи: на текущий момент самой актуальной версией библиотеки является 2.0.0.0. Ссылка на статью-обзор по новой версии: "Встречайте AINStringUtils 2. Новая версия библиотеки для работы со строками в .NET"

Если же вы хотите скачать самую первую версию библиотеки AINStringUtils, то ссылка для скачивания версии 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