Доброго времени суток, друзья.
Сегодня мы выпустили релиз нашей библиотеки 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