CoderNotes - заметки программиста

Публикации  »  Visual Basic Scripting (VBS)
Скидка 65% на Skillbox

Получите скидку 65% на любой курс программирования на популярной образовательной платформе Skillbox!

Подробнее
Бесплатный хостинг + SSL-сертификат

Зарегистрируйте домен и получите 2 месяца бесплатного хостинга и SSL-сертификат на 1 год в подарок

Подробнее

Встроенные функции в VBScript

Эта статья содержит перечень и краткое пояснение к математическим, строковым и другим функциям в языке VBScript. Данные функции позволят преобразовывать строки, числа, а так же дату и время. Информация взята с сайта script-coding.com

Математические функции

Функция Описание
Abs(x)

Возвращает абсолютное значение числа x.

Int(x)

Возвращает целую часть числа x. Если х - отрицательное число, функция вернёт ближайшее целое число, меньшее, чем х.

Fix(x)

Возвращает целую часть числа x. Если х - отрицательное число, функция вернёт ближайшее целое число, большее, чем х.

Sgn(x)

Знаковая функция числа x. Возвращает 1 для чисел больше нуля, 0 для нуля и -1 для чисел меньше нуля.

Round(x, [numdecimal])

Возвращает результат округления числа x с точностью до numdecimal знаков после запятой.

Rnd([x])

Возвращает случайное число от 0 до 1. Необязательный аргумент является начальным значением для генерации случайных чисел.

Sqr(x)

Возвращает квадратный корень числа x.

Sin(x)

Возвращает синус числа x.

Cos(x)

Возвращает косинус числа x.

Tan(x)

Возвращает тангенс числа x.

Atn(x)

Возвращает арктангенс числа x.

Exp(x)

Экспоненциальная функция, возвращает число е в степени x.

Log(x)

Возвращает натуральный логарифм числа x.

Строковые функции

Функция Описание
Asc(str)

Возвращает ASCII-код первого символа в строке str.

Chr(code)

Возвращает символ с ASCII-кодом code.

InStr([start,] str1, str2[, compare])

Возвращает индекс символа, с которого начинается первое вхождение подстроки str2 в строку str1. Параметр start задаёт номер символа, с которого следует начинать поиск (если не задан, то с начала строки). Поиск производится слева направо. Параметр compare задаёт режим сравнения при обработке строк (0 - двоичное сравнение, 1 - текстовое сравнение).

InStrRev(str1, str2[, start[, compare]])

То же самое, что InStr, но поиск производится справа налево, т.е возвращается номер последнего символа, с которого начинается вхождение подстроки str2 в строку str1.

Join(list[, delim])

Возвращает строку, полученную в результате конкатенации подстрок, содержащихся в массиве list. Параметр delim задаёт символ разделителя (по умолчанию - пробел).

Split(expr[, delim[, count[, compare]]])

Возвращает массив строк, полученных в результате разбиения строки expr на подстроки. Параметр delim задаёт символ разделителя (по умолчанию - пробел). Параметр count определяет число подстрок (по умолчанию - все). Параметр compare задаёт режим сравнения при обработке строк (0 - двоичное сравнение, 1 - текстовое сравнение).

LCase(str)

Возвращает строку, в которой все символы преобразованы к нижнему регистру.

UCase(str)

Возвращает строку, в которой все символы преобразованы к верхнему регистру.

Left(str, len)

Возвращает len символов с начала строки str.

Right(str, len)

Возвращает len символов с конца строки str.

Mid(str, start[, len]))

Возвращает из строки str подстроку, которая начинается с позиции start и имеет длину len. Если параметр len не указан, возвращаются все символы до конца строки.

Len(str)

Возвращает число символов в строке str.

LTrim(str)

Возвращает строку, в которой удалены все начальные пробелы.

RTrim(str)

Возвращает строку, в которой удалены все конечные пробелы.

Trim(str)

Возвращает строку, в которой удалены все начальные и конечные пробелы.

Replace(expr, find, replacewith[, start[, count[, compare]]])

Возвращает строку, которая получается из строки expr путём замен входящих в неё подстрок find на подстроки replacewith. Параметр start определяет начальную позицию поиска. Параметр count определяет число замен (по умолчанию - все). Параметр compare задаёт режим сравнения при обработке строк (0 - двоичное сравнение, 1 - текстовое сравнение).

Space(x)

Возвращает строку, состоящую из х пробелов.

String(number, char)

Возвращает строку, состоящую из number символов char.

StrComp(str1, str2[, compare])

Сравнивает строки. Если str1<str2, возвращается -1, если str1=str2, возвращается 0, если str1>str2, возвращается 1. Параметр compare задаёт режим сравнения при обработке строк (0 - двоичное сравнение, 1 - текстовое сравнение).

StrReverse(str)

Возвращает строку, полученную из строки str путём изменения порядка символов в строке на обратный.

FormatCurrency(expr[, numDigitsAfterDecimal[, includeLeadDigit[, useParens[, groupDigits]]]])

Возвращает строку, отформатированную в денежном формате. Параметр expr задаёт значение для форматирования. Если необязательные параметры не заданы, значения берутся из региональных настроек. Параметр numDigitsAfterDecimal задаёт количество десятичных разрядов справа от точки. Параметр includeLeadDigit задаёт отображение лидирующих нулей для дробных значений (true или false). Параметр useParens задаёт отображение скобок для отрицательных значений (true или false). Параметр groupDigits задаёт группировку разрядов с использованием разделителя из региональных настроек (true или false).

FormatDateTime(date[, namedFormat])

Возвращает строку, отформатированную в формате даты-времени. Параметр date задаёт значение для форматирования. Параметр namedFormat задаёт способ форматирования (см. описание констант форматов даты и времени в разделе "Константы даты и времени").

FormatNumber(expr[, numDigitsAfterDecimal[, includeLeadDigit[, useParens[, groupDigits]]]])

Возвращает строку, отформатированную в числовом формате. Параметр expr задаёт значение для форматирования. Если необязательные параметры не заданы, значения берутся из региональных настроек. Параметр numDigitsAfterDecimal задаёт количество десятичных разрядов справа от точки. Параметр includeLeadDigit задаёт отображение лидирующих нулей для дробных значений (true или false). Параметр useParens задаёт отображение скобок для отрицательных значений (true или false). Параметр groupDigits задаёт группировку разрядов с использованием разделителя из региональных настроек (true или false).

FormatPercent(expr[, numDigitsAfterDecimal[, includeLeadDigit[, useParens[, groupDigits]]]])

Возвращает строку, отформатированную в процентном формате (аргумент умножается на 100). Параметр expr задаёт значение для форматирования. Если необязательные параметры не заданы, значения берутся из региональных настроек. Параметр numDigitsAfterDecimal задаёт количество десятичных разрядов справа от точки. Параметр includeLeadDigit задаёт отображение лидирующих нулей для дробных значений (true или false). Параметр useParens задаёт отображение скобок для отрицательных значений (true или false). Параметр groupDigits задаёт группировку разрядов с использованием разделителя из региональных настроек (true или false).

Функции для работы с датой и временем

Функция Описание
Date

Возвращает текущую системную дату.

Now

Возвращает текущие системные дату и время в виде, соответствующем региональным настройкам Windows.

Time

Возвращает текущее системное время.

Timer

Возвращает количество секунд, прошедших с полуночи.

IsDate(expr)

Возвращает true, если параметр expr задаёт корректную дату, и false в противном случае.

Year(date)

Выделяет год из даты, заданной параметром date, и возвращает это целое число.

Month(date)

Выделяет номер месяца из даты, заданной параметром date, и возвращает целое число от 1 до 12.

Day(date)

Выделяет номер дня месяца из даты, заданной параметром date, и возвращает целое число от 1 до 31.

Weekday(date[, firstdayofweek])

Возвращает целое число - день недели для даты, заданной параметром date. Параметр firstdayofweek - константа, показывающая, какой из дней недели считать первым.

Hour(time)

Выделяет номер часа из даты или момента времени, заданных параметром time, и возвращает целое число от 0 до 23.

Minute(time)

Выделяет количество минут из даты или момента времени, заданных параметром time, и возвращает целое число от 0 до 59.

Second(time)

Выделяет количество секунд из даты или момента времени, заданных параметром time, и возвращает целое число от 0 до 59.

DateValue(date)

Возвращает переменную подтипа Date, которая соответствует дате, заданной символьным параметром date.

TimeValue(time)

Возвращает переменную подтипа Date, которая соответствует времени, заданному символьным параметром time.

DateSerial(year, month, day)

Возвращает переменную подтипа Date, которая соответствует указанным году (параметр year), месяцу (параметр month) и дню (параметр day).

TimeSerial(hour, minute, second)

Возвращает переменную подтипа Date, которая соответствует указанным часу (параметр hour), минуте (параметр minute) и секунде (параметр second).

MonthName(month[, abbr])

Возвращает наименование для месяца с номером month. Если параметр abbr равен true, наименование месяца представляется в виде аббревиатуры, если false - в полном виде.

WeekdayName(weekday[, abbr[, firstdayofweek]])

Возвращает наименование дня недели с порядковым номером weekday. Если параметр abbr равен true, наименование дня недели представляется в виде аббревиатуры, если false - в полном виде. Параметр firstdayofweek - константа, показывающая, какой из дней недели считать первым.

DateAdd(interval, number, date)

Возвращает дату, отстоящую от даты date на number интервалов, заданных параметром interval, который может принимать значения:
"yyyy" - год
"q" - квартал
"m" - месяц
"y" - день года
"d" - день
"w" - день недели
"ww" - неделя года
"h" - час
"n" - минута
"s" - секунда

DateDiff(interval, date1, date2[, firstdayofweek[, firstweekofyear]])

Возвращает количество интервалов interval между датами date1 и date2. Возможные значения параметра interval - те же, что и в функции DateAdd. Параметр firstdayofweek - константа, показывающая, какой из дней недели считать первым. Параметр firstweekofyear - константа, показывающая, какую неделю считать первой в году.

DatePart(interval, date[, firstdayofweek[, firstweekofyear]])

Возвращает ту часть даты, которая соответствует параметру interval. Возможные значения параметра interval - те же, что и в функции DateAdd. Параметр firstdayofweek - константа, показывающая, какой из дней недели считать первым. Параметр firstweekofyear - константа, показывающая, какую неделю считать первой в году.

Прочие функции

Функция Описание
Array(arglist)

Возвращает массив, составленный из элементов списка arglist. Элементы в списке arglist должны быть отделены друг от друга запятыми.

LBound(arrayname[, dimension])

Возвращает наименьшее значение, которое которое может принимать индекс в массиве arrayname в размерности dimension (по умолчанию параметр dimension равен 1).

UBound(arrayname[, dimension])

Возвращает наибольшее значение, которое которое может принимать индекс в массиве arrayname в размерности dimension (по умолчанию параметр dimension равен 1).

Filter(inputStrings, value[, include[, compare]])

Возвращает массив, созданный путём фильтрации переданного массива по заданным критериям. Параметр inputStrings - исходный одномерный массив строк. Параметр value - строка, критерий отбора. Параметр include - если задано true, в результат попадут только строки, которые содержат подстроку value, если задано false - в результат попадут только строки, которые не содержат подстроку value. Параметр compare - тип сравнения (0 - двоичный, 1 - текстовый).

IsArray(varname)

Возвращает true, если параметр varname является массивом, и false в противном случае.

IsDate(varname)

Возвращает true, если параметр varname задаёт корректную дату, и false в противном случае.

IsEmpty(varname)

Возвращает true, если переменная varname объявлена, но не инициализирована, и false в противном случае.

IsNull(varname)

Возвращает true, если переменная varname не содеоржит никаких корректных данных, и false в противном случае.

IsNumeric(varname)

Возвращает true, если переменная varname может быть рассмотрена в качестве числа, и false в противном случае.

IsObject(varname)

Возвращает true, если переменная varname является указателем на внешний объект, и false в противном случае.

VarType(varname)

Возвращает числовое значение, соответствующее подтипу переменной varname (см. описание констант подтипов данных в разделе "Прочие константы").

TypeName(varname)

Возвращает строку, содержащую тип переменной varname.

Hex(number)

Возвращает шестнадцатеричное представление (в символьном виде) числа number.

Oct(number)

Возвращает восьмеричное представление (в символьном виде) числа number.

MsgBox(prompt[, buttons][, title][, helpfile, context])

Выводит на экран диалоговое окно с сообщением и различными кнопками и возвращает результат нажатия на одну из кнопок. Возможные варианты возврата - см. описание констант нажатий на кнопки в разделе "Константы для диалоговых окон". Параметр prompt задаёт текст сообщения. Числовой параметр buttons определяет состав кнопок, значок, кнопку по умолчанию и режим модальности окна - см. описание констант в разделе "Константы для диалоговых окон" (значения необходимых констант для передачи в параметр buttons нужно просто сложить). Параметр title задаёт текст заголовка диалогового окна. Параметр helpfile задаёт путь к файлу помощи. Параметр context задаёт идентификатор содержания помощи.

InputBox(prompt[, title][, default][, xpos][, ypos][, helpfile, context])

Выводит на экран диалоговое окно со полем ввода и кнопками ОК, Отмена и возвращает введённую в этом окне символьную строку. Параметр prompt задаёт текст сообщения, которое выводится рядом с полем ввода. Параметр title задаёт текст заголовка диалогового окна. Параметр default задаёт значение по умолчанию для поля ввода. Параметры xpos и ypos определяют координаты левого верхнего угла окна. Параметр helpfile задаёт путь к файлу помощи. Параметр context задаёт идентификатор содержания помощи.

CreateObject(servername.typename[, location])

Создаёт экземпляр объекта автоматизации и возвращает ссылку на него. Здесь servername - имя приложения, являющегося сервером автоматизации, typename - тип или класс создаваемого объекта, location - сетевое имя компьютера, на котором будет создан объект.

GetObject([pathname][, classname])

Возвращает ссылку на объект класса classname, который хранится в отдельном файле, путь к которому задаётся параметром pathname.

CBool(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных boolean (true или false). Например, CBool(3=2) или CBool("-1").

CByte(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных byte (целое число от 0 до 255). Например, CByte(256) вызовет ошибку переполнения.

CCur(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных currency (специальный числовой формат для денежных величин).

CDate(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных date/time (даты от 1 января 100 года до 31 декабря 9999 года).

CDbl(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных double (числа с плавающей точкой двойной точности).

CInt(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных integer (целые числа в диапазоне от -32768 до 32768).

CLng(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных long (целые числа в диапазоне от -2 147 483 648 до 2 147 483 647).

CSng(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных single (числа с плавающей точкой одинарной точности).

CStr(expr)

Возвращает значение, полученное в результате преобразования выражения expr к подтипу данных string.

Eval(expr)

Вычисляет выражение и возвращает результат. Например, Eval(3=2).

GetLocale

Возвращает текущее значение (ID) настроек локализации (набор установок языка, региона, раскладки клавиатуры и т.д.). Возможные значения - см. MSDN статью "Locale ID (LCID) Chart".

SetLocale(lcid)

Возвращает текущее значение (ID) настроек локализации (набор установок языка, региона, раскладки клавиатуры и т.д.) и устанавливает новое. Возможные значения - см. MSDN статью "Locale ID (LCID) Chart".

ScriptEngine

Возвращает название текущего языка, например, "VBScript".

ScriptEngineBuildVersion

Возвращает номер сборки текущей среды исполнения скриптов.

ScriptEngineMajorVersion

Возвращает номер версии текущей среды исполнения скриптов.

ScriptEngineMinorVersion

Возвращает номер подверсии текущей среды исполнения скриптов.

RGB(red, green, blue)

Возвращает целочисленное значение, соответствующее цвету RGB, заданному с помощью трёх составляющих - красного, зелёного и синего цветов числами от 0 до 255.

Категория: Visual Basic Scripting (VBS)

Комментарии к статье:

Пока комментариев нет, ваш будет первым ;)

Добавить комментарий: