Описание API BinaryWind Library 0.2

С предыдущей версии уже существующие API не изменялись, не удалялись и не получали статус устаревших и нерекомендованных для использования (obsolete). Обратная совместимость сохранена. Этот релиз включает в себя описанные ниже дополнения.

BinaryWind
BinaryWind
Extensions
NumericStringValueConstants As Integer
Перечисление констант для аргумента base метода-расширения IsNumeric().
Const Decimal As BinaryWind.Extensions.NumericStringValueConstants= 0
Константа, указывающая на необходимость определения числа в десятичной системе счисления.
Const Binary As BinaryWind.Extensions.NumericStringValueConstants= 1
Константа, указывающая на необходимость определения числа в двоичной системе счисления.
Const Octal As BinaryWind.Extensions.NumericStringValueConstants= 2
Константа, указывающая на необходимость определения числа в восьмиричной системе счисления.
Const Hexadecimal As BinaryWind.Extensions.NumericStringValueConstants= 3
Константа, указывающая на необходимость определения числа в шестнадцатиричной системе счисления.
CSharp
Содержит методы-расширения, оригинальные версии которых не поддерживаются в C#.
Для Visual Basic.Net вместо BinaryWind.Extensions.CSharp рекомендуется импортировать только пространство имён BinaryWind.Extensions.
Arrays
Public Function Append(Of T)(ByVal targetArray() As T, ByVal element As T) As T()
Возвращает копию массива targetArray(), предварительно добавив element в конец массива.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function Insert(Of T)(ByVal targetArray As T(), ByVal element As T, ByVal position As Integer) As T()
Возвращает копию массива targetArray(), вставив element в указанную позицию.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function Truncate(Of T)(ByVal targetArray As T(), ByVal count As Integer) As T()
Возвращает копию массива targetArray(), удалив count элементов в конце массива.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function Remove(Of T)(ByVal targetArray As T(), ByVal index As Integer) As T()
Возвращает копию массива targetArray(), удалив из него элемент на позиции index.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function RemoveRange(Of T)(ByVal targetArray As T(), ByVal index As Integer, ByVal count As Integer) As T()
Возвращает копию массива targetArray(), удалив из него count элементов, начиная с позиции index.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Diagnostics
Public Function GetParentProcess(ByVal process As Process) As Process
Возвращает объект типа Process, представляющий собой процесс, от которого унаследованы параметры текущего. Обычно это родительский процесс (то есть тот, который запустил указанный).
FileSystem
Public Sub CreateLink(ByVal info As FileInfo, ByVal linkFileName As String)
Создаёт символическую ссылку на файл info.FullName в расположении linkFileName.
Примечание: для создания символических ссылок в Windows обычно требуются права администратора. В случае неудачи создаётся исключение типа Win32Exception.
Public Sub CreateLink(ByVal info As DirectoryInfo, ByVal linkFileName As String)
Создаёт символическую ссылку на папку info.FullName в расположении linkFileName.
Примечание: для создания символических ссылок в Windows обычно требуются права администратора. В случае неудачи создаётся исключение типа Win32Exception.
Numeric
Public Function IsNumeric(ByVal value As String) As Boolean
Public Function IsNumeric(ByVal value As String, ByVal base As NumericStringValueConstants) As Boolean
Определяет, является ли вероятное строковое представление числа value числом в указанной системе счисления base.
Возвращает True, если проверяемая строка состоит только из "0" или "1" в случае проверки на двоичное число, любых цифр и единственного символа плавающей точки (в случае проверки на десятичное), любых цифр и символов латинского алфавита от "A" до "F" (в случае проверки на шестнадцатиричное) или любых цифр от 0 до 7, а так же строка начинается на "0" (в случае проверки на восьмиричное).
Функцией не поддерживаются специфические префиксы и постфиксы, указывающие на разрядность числа (кроме обязательного для восьмиричных чисел префикса "0"), такие как "0x", "#", "&H", "h" и т. п.
Перегрузка IsNumeric(value) подразумевает, что параметр base по умолчанию равен NumericStringValueConstants.Decimal, то есть value тестируется на соответствие числу в десятичной системе счисления.
Strings
Public Function ToHexString(ByVal array() As Byte) As String
Возвращает строковое шестнадцатиричное представление массива байтов array().
Например, массив {0,1,2,127,253,254,255} будет преобразован в строку "0001027FFDFEFF".
Примечание о производительности: не рекомендуется использовать для массивов с очень большим количеством элементов. Помните, что для результирующей строки требуется выделить значительно больше памяти, чем для оригинального массива байтов - примерно вчетверо: каждый Char в строке займёт 2 байта (Unicode), а также каждый байт будет преобразован в 2 таких символа.
Public Function HexToBytes(ByVal hexadecimal As String) As Byte()
Возвращает массив байтов, соответствующий их строковому шестнадцатиричному представлению.
Эта функция выполняет операцию, обратную String.ToHexString().
Time
Public Function IsNegative(ByVal timeSpan As TimeSpan) As Boolean
Возвращает True, если значение timeSpan представляет собой отрицательный промежуток времени, то есть такой, который начинается позже, чем заканчивается.
Примечание: эта функция всего лишь возвращает результат сравнения timeSpan.Ticks < 0 и введена по двум причинам: неочевидности такого подхода для определения отрицательных промежутков времени, а также для повышения читаемости кода.
Категория: BinaryWind (.Net DLL) | Добавил: BinaryWind (13 Июня 2019)
Просмотров: 8 | Теги: Library, Windows, .Net, update, binarywind, dll | Рейтинг: 0.0/0
Всего комментариев: 0
Имя *:
Email *:
Все смайлы
Код *: