Винниченко И.В. Автоматизация процессов тестирования

Подождите немного. Документ загружается.

60 Глава 3. Язык скриптов

Функция возвращает индекс элемента aElem в массиве аАггау (О, если

элемент не найден).

Пример. Следующий блок кода возвращает 3:

aiTempPerDay

{...}

{10.

12.

17}

{-1.

17.

-9}

{U.

1. 1.

{75.

32.

18.

103}

{9.

-7. -2.

ArrayFind (aiTempPerDay[l]. 8)

ArrayResize (аАггау, iNewSize [, iDim])

Здесь аАггау- имя массива; iNewSize

—

новое количество элементов;

iDim

—

измерение массива.

Функция изменяет заданные размеры массива.

Пример. Следующий блок кода создает массив 5 х 4 и перезадает

его как массив 5x8:

INTEGER aiTempPerDay[5][4]

ArrayResize (aiTempPerDay. 8. 2)

ArraySize (аАггау [, iDim])

Здесь аАггау

—

имя массива; iDim

—

измерение массива.

Функция возвращает количество элементов массива.

Пример. Следующий блок кода возвращает 4:

INTEGER aiTempPerDay[5][4]

ArraySize (aiTempPerDay, 2)

ArraySort (аАггау [, iMaxIndex])

Здесь аАггау

—

имя массива; iMaxIndex

—

максимальное количество

элементов, включенных в сортировку.

Функция сортирует массив.

Пример. Следующая строка кода сортирует первые три элемента

массива:

ArraySort (aiTempPerDay[5]. 3)

Для работы со списками 4test использует следующие функции:

ListAppend (IList. aElem)

где IList ~ имя списка; aElem

—

искомый элемент.

Функция добавляет значение aElem в список IList.

функции работы с массивами 61

Пример. Следующая строка кода добавляет значение apples в спи-

сок IsFruit:

ListAppend (IsFruit. "apples")

ListCount (IList)

Функция возвращает количество элементов в списке.

Пример. Следующий блок кода возвращает 3:

LIST

INTEGER liNumber = {...}

-1

IListCount (liNumber)

ListDelete (IList, ilndex)

Здесь IList

—

имя списка; ilndex

—

искомый элемент.

Функция удаляет указанный элемент списка.

Пример. Следующая строка кода удаляет третий элемент списка:

ListDelete (liNum. 3)

Listlnsert (IList. ilndex, altem)

Здесь IList — имя списка; ilndex

—

позиция изменения элемента;

aElem

—

вставляемый элемент.

Функция вставляет значение aElem в позицию ilndex списка IList.

Пример. Следующий блок кода вставляет значение

во второй

элемент списка

LIST Is = {...}

"g"

"s"ListInsert (Is, 2. "m")Print (Is) // список: {g. m. s}

ListMerge (lOrig. 1Merge [. iMergePos])

Здесь lOrig — имя первого списка; 1 Merge — имя второго списка;

iMergePos -- номер элемента первого списка, в который вставляется

второй список.

Функция объединяет списки lOrig и 1 Merge.

Пример. Следующий блок кода объединяет два списка:

LIST X = {...}

2ListMerge (х, {5. 6}) // список: {1, 2. 5. 6}

62 Глава 3. Язык скриптов

ListFind (IList. altem)

Здесь IList ~ имя списка; altem

—

искомый элемент.

Функция возвращает индекс элемента altem в списке IList (О, если

элемент не найден).

Пример. Следующий блок кода возвращает 2:

LIST IsFruit«{...}

"apples"

"oranges"

"bananas"Print (ListFind (IsFruit, "oranges")

ListRead (IsList. sFileName)

Здесь IList

—

имя списка; sFileName

—

имя файла.

Функция считывает значения из файла sFileName в список IList.

Пример. Следующая строка кода считывает значения из файла

fruit.txt и записывает их в список IsFruit:

ListRead (IsFruit, "fruit.txt" )

ListSort (IList)

Функция сортирует список IList.

Пример. Следующий блок кода сортирует список:

LISTliNum«{...}1010-lListSort (liNum) //список: {-1, О, 1, 10}

ListPrint (IList)

Функция распечатывает список IList в файл результатов.

Пример. Следующий блок кода распечатывает список:

LIST IFruit-{...}

"apples"

"oranges"

"bananas"

ListPrint (IFruit)

Prints:// apples// oranges// bananas

SQABasic (Robot)

SQABasic предоставляет пользователю следующие функции для ра-

боты с массивами.

Erase Array [. Array ]

Функция удаляет все элементы массива (реинициализирует их).

Пример. Следующая строка удаляет элемент массива filenames:

Erase filenamesО

функции работы с массивами 63

ReDim

[

Preserve

]

variableName

(

subscriptRange

. ... )

[As

[ New ]

type]

, ...

Здесь variableName

—

имя изменяемого массива; subscriptRange

—

но-

вые границы массива; type

—

тип данных массива.

Функция изменяет заданные границы массива. Если опция Preserve

указана, то значения массива сохраняются. В противном случае пе-

ределанный массив реинйциализируется.

Пример. Следующий блок кода создает динамический массив

и перезадает его как массив из 11 элементов:

Dim varrayO as Double

ReDim varray(ll)

Option Base lowerBound^

Функция устанавливает нижнюю границу массива по умолчанию

(О или 1).

Пример. Следующая строка устанавливает нижнюю границу мас-

сива как 1:

Option Base 1

LBound( arrayname [, dimension ] )

Здесь arrayname

—

имя массива; dimension

—

измерение массива.

Функция возвращает нижнюю границу массива.

Пример. Следующий блок кода создает динамический массив

и возвращает 1 как нижнюю границу массива:

Option Base 1

Dim

varrayO as Double

LBound(varray)

UBound( arrayname [. dimension ] )

Здесь arrayname

—

имя массива; dimension

—

измерение массива.

Функция возвращает верхнюю границу массива.

Пример. Следующий блок кода создает динамический массив

и возвращает 11 как верхнюю границу массива:

Dim

varrayO as Double

ReDim

varray(ll)

UBound(varray)

64 Глава 3. Язык скриптов

Функции работы со строками

Функции работы со строками являются встроенными функциями язы-

ка и позволяют работать со строками (искать значения в строке, по-

лучать длину строки, сравнивать строки и т. д). Их набор напрямую

зависит от выбранного языка.

TSL (WinRunner)

TSL доставляет пользователю следующие функции работы со стро-

ками.

ascii(string)

Функция возвращает код символа.

Пример. Следующая строка кода возвращает 77:

asciiC'M");

compare_text (

strl,

str2 [. charsi, chars2 ] )

Здесь strl и str2

—

сравниваемые строки; charsi

—

значение в strl,

которое следует принимать как идентичное значению chars2 в str2;

chars2

—

значение в str2, которое следует принимать как идентичное

значению charsi в strl.

Функция сравнивает две строки.

Пример. Следующая строка кода сравнивает две строки, игнори-

руя разницу между «I» и «1»:

compare_text

("File".

"File", "I". "1");

index

(

stringl.

string2

)

Здесь stringl

—

строка, в которой производится поиск; string2

—

стро-

ка, которую ищут.

Функция возвращает положение string2 в stringl (О, если строка не

найдена).

Пример. Следующая строка кода возвращает 4:

index("a1ibaba","ba");

length ( string )

Функция возвращает длину строки.

Пример. Следующая строка кода возвращает 8:

length ("universe"):

функции работы со строками 65

index

(

string, regularexpression

)

Здесь string — строка, в которой производится поиск; regular^

expression

—

«маска» поиска.

Функция возвращает положение регулярного выражения («маски»

поиска) в строке string (О, если строка не найдена).

Пример. Следующая строка кода возвращает 13:

match ("the name is Bond", "[A-Z][a-2]*");

split ( string, array [ , fie1d_separators ] )

Здесь string

—

разбиваемая строка; array

—

массив, куда будет про-

изведено разбиение; fie1d_separators

—

флаг разбивки.

Функция разбивает строку на массив строк по флагу разбивки.

Пример. Следующая строка кода разбивает строку на массив, со-

стоящий из элементов

["С:",

"Temp", "WinRunner"]:

split ("CrWTempWWinRunner", path_array, "W"):

sprintf ( format,

expl,

exp2 expn )

Здесь format

—

строка и спецификатор формата; ехр

—

выражение,

которое будет отформатировано.

Функция возвращает отформатированную версию данной строки.

Пример. Следующий блок кода возвращает «The abbreviation for

January

is:

Jan»:

month = "January";

x= sprintf ("The abbreviation for January is:

^.3s",

month):

substr ( string, position [, length ] )

Здесь string

—

данная строка; position

—

позиция в данной строке;

length

—

длина отрезаемой части.

Функция возвращает часть данной строки длиной length, считая от

position.

Пример. Следующая строка кода возвращает строку «Ночной»:

substr ("Ночной Дозор". 1, 6):

tolower ( string )

Функция возвращает данную строку в нижнем регистре.

Пример. Следующая строка кода возвращает строку «ночной до-

зор»:

tolower ("НОЧНОЙ ДОЗОР"):

66 Глава 3. Язык скриптов

toupper ( string )

Функция возвращает данную строку в верхнем регистре.

Пример. Следующая строка кода возвращает строку «НОЧНОЙ

ДОЗОР»:

toupper ("ночной дозор");

4TEST (Silkiest)

4test предосташшет пользователю саедующие функции работы со стро-

ками.

IsAlpha (sString)

Функция проверяет, является ли первый символ в строке буквен-

ным значением.

Пример. Следующая строка кода возвращает TRUE:

IsAlpha ("hello")

IsDigit (sString)

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

значением.

Пример. Следующая строка кода возвращает TRUE:

IsDigit

("123heno")

IsSpace (sString)

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

значением.

Пример. Следующая строка кода возвращает TRUE:

IsSpace (" hello")

GetField (sString, sDelim. iField)

Здесь sString

—

искомая строка; sDelim

—

флаг разбиения (символ,

на основе которого будет произведена разбивка); iField ~ номер воз-

вращаемого сегмента.

Функция возвращает сегмент строки по заданным параметрам.

Пример. Следующая строка кода возвращает «паше»:

GetField ("name|rank|seriair. '\\ I)

Left (sString. iNumChars)

Здесь sString

—

искомая строка; iNumChars

—

количество возвращае-

мых символов.

функции работы со строками 67

Функция возвращает заданное количество символов, начиная от са-

мого левого символьного значения.

Пример. Следующая строка кода возвращает «Segue»:

Left

("Segue

Software". 5)

Right (sString. iNumChars)

Здесь sString

—

искомая строка; iNumChars

—

количество возвращае-

мых символов.

Функция возвращает заданное количество символов, начиная от са-

мого правого символьного значения.

Пример. Следующая строка кода возвращает «World»:

Right

("Hello

World". 5)

Ltrim (sToStrip)

Функция возвращает строку с удаленными начальными пробелами.

Пример. Следующая строка кода возвращает «Has whitespace »:

Ltrim (" Has whitespace ")

Rtrim (sToStrip)

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

Пример. Следующая строка кода возвращает « Has whitespace»:

Rtrim (" Has whitespace ")

Trim (sToStrip)

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

Пример. Следующая строка кода возвращает «Has whitespace»:

Trim (" Has whitespace ")

Space (iCount)

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

Пример. Следующая строка кода выводит «12345 67890»:

Print ("12345" + Space (10) + "67890")

Tabs(iAmount)

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

Пример. Следующая строка кода выводит «string with leading tabs»:

Print C{Tabs(2)}stringwith leading tabs")

68 Глава 3. Язык скриптов

Replicate (sOrig, iCopies)

Функция возвращает значение строки (sOrig) заданное количество

(iCopies) раз.

Пример. Следующая строка кода возвращает «АААА»:

Replicate ("А", 4)

Lower ( string )

Функция возвращает данную строку в нижнем регистре.

Пример. Следующая строка кода возвращает строку «ночной до-

зор».

Lower ("НОЧНОЙ ДОЗОР")

Upper (sToConvert)

Функция возвращает данную строку в верхнем регистре.

Пример. Следующая строка кода возвращает строку «НОЧНОЙ

ДОЗОР».

Upper ("ночной дозор")

MatchStr (sPattern. sString)

Здесь sPattern

—

«маска» поиска; sString

—

искомая строка.

Функция проверяет строку на присутствие «маски» поиска.

Пример. Следующая строка кода возвращает TRUE:

MatchStr ("*HELLO*". "hi hello there")

SubStr (sString, iPos [, iLen])

Здесь sString

—

данная строка; iPos

—

позиция в данной строке; iLen

—

длина вырезаемой части.

Функция возвращает часть данной строки длиной iLen, считая от

position.

Пример. Следующая строка кода возвращает строку «Ночной»:

SubStr ("Ночной Дозор", 1. 6)

StrPos (sSubstr, sTarget [, bBackward]))

Здесь sSubstr — строка, в которой производится поиск; sTarget —

строка, которую ищут; bBackward

—

флаг начала поиска (TRUE, еслр!

поиск производится с конца, не указывается, если с начала).

Функция возвращает положение sTarget в sSubstr (О, если строка не

найдена).

функции работы со строками 69

Пример. Следующая строка кода возвращает 4:

StrPos("ba","a11baba")

StrTran (sOrig, sSearch, sReplace)

Здесь sOrig

—

данная строка; sSearch

—

Р1скомая строка; sReplace

—

строка-замена.

Функция заменяет sSearch на sReplace в sOrig.

Пример. Следующая строка кода возвращает «one & two &

three»:

StrTran ("one and two and three",

"and".

"&")

Stuff (sOrig, iPos,

ILen,

sReplace)

Здесь sOrig ~ данная строка; iPos

—

начальная позиция изменения;

ILen — количество удаляемых символов; sReplace — вставляемые

значения.

Функция вставляет sReplace в sOrig, начиная с IPos, удалив при этом

ILen символов, начиная с iPos.

Пример. Следующая строка кода возвращает «hello OUT there»:

Stuff

("hello

there",7.0."OUT")

Пример. Следующая строка кода возвращает «hello WORLD»:

Stuff

("hello

there", 7,5. "WORLD)

Пример. Следующая строка кода возвращает «hello»:

Stuff

("hello

there".

6.6."")

Len (sString)

Функция возвращает длину строки.

Пример. Следующая строка кода возвращает 5:

Len ("Segue")

SQABasic (Robot)

SQABasic предоставляет пользователю следующие функции работы

со строками.

GetField$( string! . field_number^ , separator_chars$ )

где strings

—

искомая строка; field_number^

—

номер возвращаемого

сегмента; separator_chars$

—

флаг разбиения (символ, на основе ко-

торого будет произведена разбивка).

Функция возвращает сегмент строки по заданным параметрам.