Функції та системнi змihhi Бейсiка

У всіх наведених нижче функціях, якщо не обумовлено протилежне, величина x являє собою будь-який допустимий числовий вираз, x$ будь-який символьний (рядковий) вираз, який має непорожнє значення, n ціле число із значенням від 0 до 255.

ABS (x) абсолютне значення x.

ASC (x$) код першого знаку ланцюжка символів.

     Значення функції ціле число від 0 до 255, яке являє собою код першого символу ланцюжка.

ATN (x) арктангенс x.

CDBL (x) перетворення x в число з подвійною точністю.

CHR$ (n) перетворення цілого в символьне.

     Значення функції рядок, який складається з єдиного символу, код якого рівний n. Функцiя CHR$ є оберненою до функції ASC.

CINT (x) заокруглення до цілого.

     x числовий вираз із значенням від 32768 до 32767. Значення функції найближче до x ціле число.

COS (x) косинус x.

     x представляє собою кут, що вимірюється в радіанах.

CSNG (x) перетворення x в число звичайної точності.

CSRLIN номер рядка поточного положення курсора.

     Значення системної змінної CSRLIN ціле число від 1 до 25, яке дорівнює номеру рядка поточної позиції курсора активної сторінки екрана.

CVD (x$) перетворення ланцюжка символів в число подвійної точності.

CVI (x$) перетворення ланцюжка символів в ціле число.

CVS (x$) перетворення ланцюжка символів в число звичайної точності.

     x$ символьний вираз, довжина якого рівна:

                   2 для функції CVI,

                   4 для функції CVS,

                   8 для функції CVD.

     Значення функції CVI (CVS, CVD) рівне значенню цілого числа (числа звичайної точності, числа подвійної точності), представленням якого в кодовій формі править аргумент функції. Функцiї необхідні при обробці файлів з довільним доступом, які містять числову інформацію. Оберненими до вказаних функцій є функції MKD$, MKI$, MKS$.

DATE$ системна дата.

     Значення системної змінної DATE$ представляє собою поточну дату у відповідному форматі, встановлену при завантаженні системи або змінену в Бейсiку оператором DATE$.

EOF (нмф) індикатор умови "кінець файлу".

     нмф номер відкритого файлу.

     Функцiя має логічне значення "істина" (1), якщо прочитано запис кінця файлу з вказаним номером, i "хибність" (0) в противному випадку.

ERL номер рядка програми, який містить помилку.

     Системна змінна ERL містить номер програмного рядка, в якому виявлена помилка. Якщо при виконанні програми помилка не була виявлена, то ERL = 0. Змiнна ERL звичайно використовується в тому випадку, коли користувач пише особисту підпрограму обробки помилок.

ERR код останньої виявленої помилки.

     Значення системної змінної ERR ціле число від 0 до 255, яке вказує код помилки. Якщо ERR = 0, то помилка не була виявлена.

EXP (x) експонента x.

FIX (x) зрізання числа до цілого.

     x будь-який числовий вираз із значенням від 32768 до 32767. Значення функції отримується відкиданням всіх цифр дробової частини значення аргументу.

FRE (x) або FRE (x$) об'єм вільної пам'яті в робочій області.

     Значення аргументу не використовується. Значення функції ціле число, що вказує об'єм (в байтах) вільної частини робочої області Бейсiка. Важливим побічним ефектом обчислення функції FRE є "збирання сміття" (якщо аргумент символьний вираз).

HEX$ (n) перетворення в ланцюжок 16-річних цифр.

     n числовий вираз із значенням від 32768 до 65535.

INKEY$ введення символу з клавіатури.

     Значення системної змінної INKEY$ ланцюжок символів довжини 0, 1 або 2: порожній ланцюжок вказує, що в буфері клавіатури немає символів; односимвольний ланцюжок містить поточний знак, зчитаний з клавіатури; двосимвольний ланцюжок містить символ розширеного коду (її перший символ завжди є 0 -й символ CHR$(0)). Змiнна INKEY$ може застосовуватися тільки як права частина оператора присвоєння.

INP (n) зчитування байту з порту введення.

     n числовий вираз із значенням від 0 до 65535, повинно бути конкретним номером порту введення ПЕОМ. Значення функції ціле число від 0 до 255 байт, прочитаний з вказаного порту.

INPUT$ (n[, [#] нмф]) зчитування ланцюжка символів з файлу.

     n числовий вираз, який задає кількість зчитуваних з файлу символів; значення n не повинно перевищувати 255;

     нмф номер відкритого файлу; за умовчанням символи зчитуються з буферу клавіатури.

INSTR ([n,] x$, y$) номер позиції першого входження ланцюжка y$ в ланцюжок x$.

     n числовий вираз із значенням від 1 до 255; за умовчанням передбачається значення 1;

     x$ та y$ будь-які символьні вирази.

INT (x) ціла частина x.

     Значення функції ціла частина значення аргументу, тобто найбільше ціле число, яке не перевищує x.

LEFT$ (x$,n) виділення перших символів ланцюжка.

     x$ будь-який символьний вираз;

     n числовий вираз із значенням від 0 до 255.

     Значенням функції є ланцюжок з перших n символів x$. Функцiя LEFT$ є частинним випадком функції MID$.

LEN (x$) довжина ланцюжка символів.

LOC (нмф) поточна позиція файлу.

     нмф номер відкритого файлу (числовий вираз).

LOF (нмф) розмір файлу.

     нмф номер відкритого файлу (числовий вираз).

LOG (x) натуральний логарифм x.

LPOS (n) поточна позиція друку.

     n числовий вираз, що вказує пристрій друку:

                   n = 0 або 1 для пристрою LPT1:,

                   n = 2 для LPT2:, n = 3 для LPT3:.

     Значення функції є номером поточної позиції в буфері відповідного пристрою друку.

MID$(x$,n[,m]) виділення частини ланцюжка символів.

     x$ будь-який символьний вираз;

     n числовий вираз із значенням від 1 до 255, що визначає номер першого символу, який виділяється з виразу x$;

     m числовий вираз із значенням від 0 до 255, що визначає кількість виділених символів; за умовчанням виділяються всі символи x$, починаючи з n -го.

     Значенням функції є ланцюжок символів, виділених з x$. При m = 0 або при n > LEN(x$) функція буде мати порожнє значення. Частинним випадком MID$ є функції LEFT$ і RIGHT$.

MKD$ (x) перетворення числа подвійної точності в ланцюжок з восьми символів.

MKI$ (n) перетворення цілого числа в ланцюжок з двох символів.

MKS$ (x) перетворення числа звичайної точності в ланцюжок з чотирьох символів.

     Вказані функції є оберненими до розглянутих вище функцій CVD, CVI, CVS.

OCT$ (n) перетворення в ланцюжок вісімкових цифр.

     n числовий вираз із значенням від 32768 до 65535.

PEEK (n) вміст байту пам'яті.

     n числовий вираз із значенням від 0 до 65535, що визначає зміщення байту в поточному кодовому сегменті (дивись оператор DEF SEG). Результат вміст байту пам'яті з вказаною адресою у форматі цілого із значенням від 0 до 255.

PLAY (n) кількість нот в буфері фонової музики.

     n фіктивний аргумент, який може приймати будь-яке значення. Значенням функції є кількість нот у буфері фонової музики (режим MB оператора PLAY). Максимальне значення функції 32.

PMAP (x,n) перетворення локальних координат екрана в фізичні i навпаки. Застосовується тільки для графічних режимів екрана.

     x координата точки екрана, яка підлягає перетворенню;

     n визначає вид перетворення (n = 0,1,2,3).

     Функцiя PMAP виконує перетворення між фізичною системою координат на екрані та локальною системою координат, визначеною в останньому виконаному операторі WINDOW.

POINT (n) координата точки екрана. Тiльки для графічних режимів екрана.

     n = 0 фізична координата x (рядок);

     n = 1 фізична координата y (стовпець);

     n = 2 локальна координата x (рядок);

     n = 3 локальна координата y (стовпець).

     Значенням функції є вказана аргументом координата поточної точки екрана. Повеpтається фізична або локальна координата в системі, встановленій останнім оператором WINDOW.

POINT (x,y) атрибут точки екрана. Тiльки для графічних режимів екрана.

     x,y числові вирази, які задають в абсолютній формі координати точки екрана. Значенням функції є атрибут (колір) вказаної точки екрана.

POS (x) стовпець поточного положення курсора.

     x фіктивний аргумент. Значення функції ціле число від 1 до 40 або до 80 в залежності від ширини екрана (дивись оператор WIDTH), визначаючий горизонтальну позицію курсора.

RIGHT$ (x$,n) виділення останніх символів ланцюжка.

     x$ будь-який символьний вираз;

     n числовий вираз із значенням від 0 до 255, що визначає довжину значення функції.

     Значення функції складається з n  останніх символів значення x$. Якщо n > LEN (x$), то значенням функції буде x$, а при n = 0 порожній ланцюжок символів.

RND [(x)] псевдовипадкове число.

     x будь-який числовий вираз. За умовчанням x = 1, у цьому випадку функція формально перетворюється в системну змінну. Функцiя виконується таким чином:

     якщо x < 0, то значення x перетворюється в ціле i використовується для встановлення початкового значення вбудованого в Бейсiк давача рiвномiрно-розподiлених на інтервалі [ 0,1) псевдовипадкових чисел; при x > 0 таких дій не проводиться; якщо x 0, то обчислюється нове псевдовипадкове число; якщо x = 0, то давач зберігає старе значення; обчислюється значення функції множенням на x (якщо x 0) значення з давача. Результат множення рiвномiрно-розподiлене на [ 0, x) псевдовипадкове число.

SCREEN (n, m [, k]) атрибут (колір) символу на екрані.

     n числовий вираз із значенням від 1 до 25;

     m числовий вираз із значенням від 1 до 40 або 80 в залежності від раніш встановленої ширини екрана;

     k числовий вираз, що розглядається як логічне значення; допустимо тільки в текстовому режимі роботи екрана; за умовчанням k = 0.

     Для графічного режиму завжди, а для текстового при k = 0 значенням функції буде ціле число, рівне коду знака, розташованого в позиції (n, m) екрана. Якщо для текстового режиму задано k = 0, то ціле число, яке є значенням функції, визначає атрибут кольору позиції (n, m) на екрані.

SGN (x) знак x.

SIN (x) синус x.

SPACE$ (n) ланцюжок пропусків.

     n числовий вираз із значенням від 0 до 255. Значення функції ланцюжок символів, який складається з n символів "пропуск".

SPC (n) виведення ланцюжка пропусків.

     n числовий вираз із значенням від 0 до 255; якщо n більше ніж ширина пристрою, для якого застосовується функція, то замість n використовується n MOD w, де w ширина пристрою.

     Функцiя застосовується тільки в операторах PRINT, LPRINT та PRINT# для виведення пропусків.

SQR (x) корінь квадратний з x.

STR$ (x) зображення числа.

     Значення функції рядок знаків, що зображує значення виразу x при виведенні на екран або друк. Оберненою до функції STR$ є функція VAL.

STRING$ (n,m) ланцюжок з n символів CHR$(m).

STRING$ (n,x$) n -кратне повторення першого символу послідовності.

TAB (n) табуляцiя до позиції n при виведенні.

TAN (x) тангенс x.

TIME$ системний час.

     Значенням системної змінної TIME$ є поточний системний час у відповідному форматі, встановлений при завантаженні системи або оператором TIME$ Бейсiка.

TIMER лічильник часу.

     Системна змінна TIMER має своїм значенням час дня. Видається число звичайної точності, значення якого кількість секунд, що пройшли від опівночі.

USR [n] (арг) виклик підпрограми на машинній мові.

     n десяткова цифра (за умовчанням 0), що відповідає цифрі, яка використовується у визначенні підпрограми на машинній мові оператором DEF USR;

     арг числовий вираз або символьна змінна; арг передається підпрограмі як аргумент.

VAL (x$) числове значення ланцюжка символів.

VARPTR (v) адреса змінної;

VARPTR (#нмф) адреса блоку управління файлом.

     v ім'я числової або символьної змінної або елемент масиву; змінна повинна мати значення в момент обчислення функції VARPTR;

     нмф номер відкритого файлу.

     В обох випадках значенням функції буде ціле число із значенням від 0 до 65535, яке представляє собою зміщення в робочій області Бейсiка.

VARPTR$ (v) покажчик змінної.

     v ім'я змінної, що має значення. Значення функції ланцюжок з трьох символів, перший з яких визначає тип змінної, а два наступні адресу змінної в робочій області Бейсiка.