ReWiA 2.0 html manual


 ----------- Lista funkcji dostępnych w wyrażeniach arytmetycznych -----------

+--------+---+----------+----------------------------------------------------+
| nazwa  |arg|typ wyniku|                       Uwagi                        |
+--------+---+----------+----------------------------------------------------+
|  abs   | 1 |   Real   |wartość bezwzględna                                 |
+--------+---+----------+----------------------------------------------------+
|  arg   | 1 |typ argu- |zwraca   wartość   n-tego   argumentu   przekazanego|
|        |   |mentu     |kompilowanej komendzie.  Argument  1  oznacza  numer|
|        |   |          |tegop argumentu. Przed wywołaniem tej funkcji zaleca|
|        |   |          |się sprawdzić  ilość przekazanych argumentów finkcją|
|        |   |          |argcnt. Typ argumentu można sprawdzić funkcją type. |
+--------+---+----------+----------------------------------------------------+
| argcnt | 0 |   Real   |zwraca ilość  argumentów  przekazanych  kompilowanej|
|        |   |          |komendzie.                                          |
+--------+---+----------+----------------------------------------------------+
|  atan  | 1 |   Real   |arcus   tangens   liczby   rzeczywistej.   Wynik   w|
|        |   |          |radianach.                                          |
+--------+---+----------+----------------------------------------------------+
|  boxx  | 0 |   Real   |zwraca szerokość  ramki w bieżącym oknie w pikselach|
|        |   |          |(punktach  ekranu).   Przydatne   w   makrach   przy|
|        |   |          |wyświetlaniu  widm   dwuwymiarowych   (patrz   makro|
|        |   |          |LOADMOON.MAC).                                      |
+--------+---+----------+----------------------------------------------------+
|  boxy  | 0 |   Real   |zwraca wysokość  ramki w  bieżącym oknie w pikselach|
|        |   |          |(punktach  ekranu).   Przydatne   w   makrach   przy|
|        |   |          |wyświetlaniu  widm   dwuwymiarowych   (patrz   makro|
|        |   |          |LOADMOON.MAC).                                      |
+--------+---+----------+----------------------------------------------------+
|   ce   | 0 |  Field   |zwraca adres pola E w bieżącym widmie               |
+--------+---+----------+----------------------------------------------------+
|   ci   | 0 |   Real   |zwraca pozycję kursora                              |
+--------+---+----------+----------------------------------------------------+
|  cos   | 1 |   Real   |cosinus liczby rzeczywistej. Argument w radianach.  |
+--------+---+----------+----------------------------------------------------+
|  crlf  | 0 |  String  |zwraca tekst zawierający znak końca linii. Używany w|
|        |   |          |makrach w  komendach PRINT  aby wymusić drukowanie w|
|        |   |          |następnej linii.                                    |
+--------+---+----------+----------------------------------------------------+
|   cs   | 0 |   Real   |zwraca numer bieżącego widma                        |
+--------+---+----------+----------------------------------------------------+
|   cw   | 0 |   Real   |zwraca numer aktywnego okna                         |
+--------+---+----------+----------------------------------------------------+
|   cx   | 0 |  Field   |zwraca adres pola X w bieżącym widmie               |
+--------+---+----------+----------------------------------------------------+
|   cy   | 0 |  Field   |zwraca adres pola Y w bieżącym widmie               |
+--------+---+----------+----------------------------------------------------+
|   cz   | 0 |  Field   |zwraca adres pola Z w bieżącym widmie               |
+--------+---+----------+----------------------------------------------------+
|   e    | 2 |typ punktu|zwraca    wartość     współrzędnej     E     punktu.|
|        |   |          |Pierwszy argument  to numer  widma, drugi  to  numer|
|        |   |          |punktu.                                             |
+--------+---+----------+----------------------------------------------------+
|   ei   | 0 |typ punktu|zwraca    wartość     współrzędnej    E    bieżącego|
|        |   |          |punktu  w  bieżącym  widmie  w  trakcie  wykonywania|
|        |   |          |komendy SET i SETA.                                 |
+--------+---+----------+----------------------------------------------------+
|  eptr  | 1 |   Real   |zwraca wartość wskaźnika EPTR danego widma          |
+--------+---+----------+----------------------------------------------------+
|errname | 1 |  String  |zwraca tekst  będący komunikatem  o  n-tym  błędzie.|
|        |   |          |Jako argumentu oczekuje numeru błędu.               |
+--------+---+----------+----------------------------------------------------+
|  exp   | 1 |   Real   |liczba e do potęgi                                  |
+--------+---+----------+----------------------------------------------------+
| fdcnt  | 1 |   Real   |zwraca  ilość   pól  w  podanym  widmie.  Wartość  0|
|        |   |          |oznacza, że widmo posiada 0 pól. Wartość -1 oznacza,|
|        |   |          |że widmo  jest puste.  Można stosować  w makrach  do|
|        |   |          |sprawdzenia czy dane widmo jest puste.              |
+--------+---+----------+----------------------------------------------------+
| fdtype | 1 |   Real   |zwraca typ  podanego pola.  Argument musi  być  typu|
|        |   |          |Field, np. fdtype(cx)                               |
+--------+---+----------+----------------------------------------------------+
|findfile| 1 |  String  |znajduje  pierwszy   plik  w  katalogu  pasujący  do|
|        |   |          |podanej nazwy  (mniej więcej odpowiednik 'dir'). Dla|
|        |   |          |przykładu findfile("*.*")  zwróci  nazwę  pierwszego|
|        |   |          |pliku w bieżącym katalogu. Gdy nie ma żadnych plików|
|        |   |          |zwracany jest  pusty tekst.  W nazwie można umieścić|
|        |   |          |inny katalog  i/lub  dysk  (np.  "e:\samples\*.sht")|
|        |   |          |lecz zwracana jest tylko nazwa pliku.               |
+--------+---+----------+----------------------------------------------------+
|  frac  | 1 |   Real   |część ułamkowa liczby                               |
+--------+---+----------+----------------------------------------------------+
|freesht | 0 |   Real   |zwraca numer pierwszego wolnego (pustego) widma, lub|
|        |   |          |-1 gdy wszystkie są zajęte                          |
+--------+---+----------+----------------------------------------------------+
| grmode | 0 |   Real   |zwraca numer trybu graficznego w jakim pracuje ReWiA|
|        |   |          |(patrz tabela  3.1). Dla  trybu 800x600x16  zwracana|
|        |   |          |jest wartość  9, dla  trybów 256  kolorowych wartość|
|        |   |          |10.                                                 |
+--------+---+----------+----------------------------------------------------+
|  int   | 1 |   Real   |część całkowita liczby                              |
+--------+---+----------+----------------------------------------------------+
|  last  | 0 |   Real   |zwraca numer ostatniego punktu w widmie. Dla widma o|
|        |   |          |długości 0 punktów będzie to -1.                    |
+--------+---+----------+----------------------------------------------------+
|lasterr | 0 |   Real   |zwraca numer błędu w ostatnio wykonywanej komendzie.|
+--------+---+----------+----------------------------------------------------+
| length | 1 |   Real   |zwraca  długość  tekstu.  Wartość  0  oznacza  pusty|
|        |   |          |tekst.                                              |
+--------+---+----------+----------------------------------------------------+
|   ln   | 1 |   Real   |logarytm naturalny                                  |
+--------+---+----------+----------------------------------------------------+
|  log   | 1 |   Real   |logarytm dziesiętny                                 |
+--------+---+----------+----------------------------------------------------+
|  max   | 2 |   Real   |większa liczba z dwu podanych                       |
+--------+---+----------+----------------------------------------------------+
|maxcolor| 0 |   Real   |zwraca ilość  dostępnych kolorów  na ekanie minus 1.|
|        |   |          |Jako wartości mogą wystąpić : 1, 3, 15 i 255.       |
+--------+---+----------+----------------------------------------------------+
|memfree | 1 |   Real   |zwraca  ilość  wolnej  pamięci  w  kilobajtach.  Dla|
|        |   |          |argumentu równego  0 jest  ilość wolnej pamięci EMS,|
|        |   |          |dla 1 ilość wolnej pamięci DOS.                     |
+--------+---+----------+----------------------------------------------------+
|  mid   | 3 |  String  |Jako wynik  zwraca wyciętą  część  tekstu.  Pierwszy|
|        |   |          |argument jest  tekstem ,  dwa  pozostałe  indeksami.|
|        |   |          |Pierwszy  znak   w  tekście   ma  indeks  zero.  Dla|
|        |   |          |przykładu mid("ABCDEF",2,4) zwraca "CDE".           |
+--------+---+----------+----------------------------------------------------+
|  min   | 2 |   Real   |mniejsza liczba z dwu podanych                      |
+--------+---+----------+----------------------------------------------------+
| mipos  | 1 |   Real   |zwraca  pozycję   min/max  według   algorytmu  mipos|
|        |   |          |(minimum różnicy  od odbicia  lustrzanego  fragmentu|
|        |   |          |widma).  Argument  (typu  Real)  określa  początkową|
|        |   |          |przybliżoną pozycję  min/max.  Ilość  uwzględnianych|
|        |   |          |punktów można zmienić komendą MIPOS.                |
+--------+---+----------+----------------------------------------------------+
|  mod   | 2 |   Real   |uogólniona funkcja  modulo.  Oczekuje  2  argumentów|
|        |   |          |typu Real.  Znak  wyniku  taki  sam  jak  pierwszego|
|        |   |          |argumentu. Żaden  z argumentów  nie musi  być liczbą|
|        |   |          |całkowitą.                                          |
+--------+---+----------+----------------------------------------------------+
|nextfile| 0 |  String  |znajduje następny  plik w katalogu pasujący do nazwy|
|        |   |          |podanej przy  wywołaniu funkcji findfile. Gdy nie ma|
|        |   |          |już więcej  plików zwracany  jest pusty  tekst.  Tak|
|        |   |          |więc wywołując najpierw finfile a potem wielokrotnie|
|        |   |          |nextfile aż  do otrzymania  pustego tekstu otrzymamy|
|        |   |          |nazwy wszystkich plików pasujących do podanej nazwy.|
|        |   |          |Można przeszukiwać tylko 1 katalog na raz.          |
+--------+---+----------+----------------------------------------------------+
|   P    | 1 |   Real   |zwraca wartość  i-tego dopasowywanego parametru przy|
|        |   |          |dopasowywaniu krzywych  komendą CURFIT.  Oczekuje  1|
|        |   |          |argumentu - numeru parametru (typu Real).           |
+--------+---+----------+----------------------------------------------------+
| parab  | 1 |   Real   |zwraca  pozycję   min/max  z  dopasowania  paraboli.|
|        |   |          |Argument (typu  Real) określa początkową przybliżoną|
|        |   |          |pozycję min/max.  Ilość uwzględnianych punktów można|
|        |   |          |zmienić komendą PARAB.                              |
+--------+---+----------+----------------------------------------------------+
|polynom | 2 |   Real   |zwraca wartość  wielomianu. Pierwszy  argument  typu|
|        |   |          |Cell (np.  3:4:4) przechowuje  adres pod którum jest|
|        |   |          |przechowywany stopień  wielomianu  i  współczynniki.|
|        |   |          |Drugi argument  to wartość współrzędnej X dla której|
|        |   |          |ma być obliczony wielomian.                         |
+--------+---+----------+----------------------------------------------------+
| poly-  | 3 |   Real   |zwraca wartość  wielomianu dwuwymiarowego.  Pierwszy|
| nom2D  |   |          |argument typu Cell (np. 3:4:4) przechowuje adres pod|
|        |   |          |którym  są   przechowywane  stopnie    wielomianu  i|
|        |   |          |współczynniki.    Drugi    argument    to    wartość|
|        |   |          |współrzędnej X  a trzeci  współrzędnej Y dla których|
|        |   |          |ma być obliczony wielomian.                         |
+--------+---+----------+----------------------------------------------------+
| r2path | 0 |  String  |zwraca nazwę  katalogu  w  którym  rezyduje  program|
|        |   |          |REWIA.EXE. Nazwa  zakończona jest  znakiem '\' nawet|
|        |   |          |wtedy gdy REWIA.EXE znajduje się w głównym katalogu.|
+--------+---+----------+----------------------------------------------------+
|  rnd   | 0 |   Real   |wartość  losowa   z  przedziału   0  -   1.  Rozkład|
|        |   |          |jednorodny.                                         |
+--------+---+----------+----------------------------------------------------+
|  sgn   | 1 |   Real   |signum :  0  dla  zera,  1  dla  dodatnich,  -1  dla|
|        |   |          |ujemnych                                            |
+--------+---+----------+----------------------------------------------------+
|  sin   | 1 |   Real   |sinus liczby rzeczywistej. Argument w radianach.    |
+--------+---+----------+----------------------------------------------------+
|  sqr   | 1 |   Real   |kwadrat argumentu (nie mylić z pierwiastkiem)       |
+--------+---+----------+----------------------------------------------------+
|  sqrt  | 1 |   Real   |pierwiastek kwadratowy                              |
+--------+---+----------+----------------------------------------------------+
|  str   | 1 |  String  |Jako argument  oczekuje liczby,  jako  wynik  zwraca|
|        |   |          |liczbę w postaci tekstowej.                         |
+--------+---+----------+----------------------------------------------------+
| strfrm | 2 |  String  |jako  wynik   zwraca  liczbę   w  postaci  tekstowej|
|        |   |          |wydrukowaną z  zadaną w  argumencie  drugim  ilością|
|        |   |          |cyfr, np. strfrm(1.234567,3)                        |
+--------+---+----------+----------------------------------------------------+
| strpos | 2 |   Real   |Oba argumenty  muszą tyć  tekstami.  Zwraca  pozycję|
|        |   |          |pierwszego wystąpienia  pierwszego znaku z argumentu|
|        |   |          |2 w  argumencie 1.  Wartość -1 oznacza, że brak jest|
|        |   |          |takiego znaku w argumencie 1.                       |
+--------+---+----------+----------------------------------------------------+
|strtime | 0 |  String  |zwraca bieżący  czas w  postaci tekstu o długości 26|
|        |   |          |znaków. Tekst  zawiera datę, dzień tygodnia, godziny|
|        |   |          |i minuty.                                           |
+--------+---+----------+----------------------------------------------------+
|  tan   | 1 |   Real   |tangens liczby rzeczywistej. Argument w radianach.  |
+--------+---+----------+----------------------------------------------------+
|  time  | 0 |   Real   |zwraca bieżący  czas podany  w sekundach od początku|
|        |   |          |1980 roku.  Można używać  w  makrach  do  realizacji|
|        |   |          |opóźnień.                                           |
+--------+---+----------+----------------------------------------------------+
|  type  | 1 |   Real   |zwraca typ argumentu. Z reguły będzie to 7 - liczba,|
|        |   |          |14 - tekst, 19 - numer pola.                        |
+--------+---+----------+----------------------------------------------------+
|  val   | 1 |   Real   |Jako argument  oczekuje tekstu zawierającego        |
|        |   |          |jako  wartość  tej  liczby.  Gdy  tekstu  nie  można|
|        |   |          |przetworzyć na  liczbę (np.  "asd456") zwracana jest|
|        |   |          |wartość 0.                                          |
+--------+---+----------+----------------------------------------------------+
|version | 0 |   Real   |zwraca wersję  programu ReWiA.  W tej wersji jest to|
|        |   |          |liczba 2.                                           |
+--------+---+----------+----------------------------------------------------+
|   X    | 0 |   Real   |zwraca wartość X przy dopasowywaniu krzywych komendą|
|        |   |          |CURFIT. W  zasadzie używana  tylko wewnątrz  komendy|
|        |   |          |CURFIT.                                             |
+--------+---+----------+----------------------------------------------------+
|   x    | 2 |typ punktu|zwraca    wartość     współrzędnej     X     punktu.|
|        |   |          |Pierwszy argument  to numer  widma, drugi  to  numer|
|        |   |          |punktu.                                             |
+--------+---+----------+----------------------------------------------------+
|   xi   | 0 |typ punktu|zwraca    wartość     współrzędnej    X    bieżącego|
|        |   |          |punktu  w  bieżącym  widmie  w  trakcie  wykonywania|
|        |   |          |komendy SET i SETA.                                 |
+--------+---+----------+----------------------------------------------------+
|  xptr  | 1 |   Real   |zwraca wartość wskaźnika XPTR danego widma          |
+--------+---+----------+----------------------------------------------------+
| xsize  | 1 |   Real   |zwraca wielkość  danego widma  w osi  X.  Wartość  0|
|        |   |          |oznacza, że widmo jest jednowymiarowe, wartość różna|
|        |   |          |od zera oznacza, że widmo jest dwuwymiarowe.        |
+--------+---+----------+----------------------------------------------------+
|   y    | 2 |typ punktu|zwraca    wartość     współrzędnej     Y     punktu.|
|        |   |          |Pierwszy argument  to numer  widma, drugi  to  numer|
|        |   |          |punktu.                                             |
+--------+---+----------+----------------------------------------------------+
|   yi   | 0 |typ punktu|zwraca    wartość     współrzędnej    Y    bieżącego|
|        |   |          |punktu  w  bieżącym  widmie  w  trakcie  wykonywania|
|        |   |          |komendy SET i SETA.                                 |
+--------+---+----------+----------------------------------------------------+
|  yptr  | 1 |   Real   |zwraca wartość wskaźnika YPTR danego widma          |
+--------+---+----------+----------------------------------------------------+
|   z    | 2 |typ punktu|zwraca    wartość     współrzędnej     Z     punktu.|
|        |   |          |Pierwszy argument  to numer  widma, drugi  to  numer|
|        |   |          |punktu.                                             |
+--------+---+----------+----------------------------------------------------+
|   zi   | 0 |typ punktu|zwraca    wartość     współrzędnej    Z    bieżącego|
|        |   |          |punktu  w  bieżącym  widmie  w  trakcie  wykonywania|
|        |   |          |komendy SET i SETA.                                 |
+--------+---+----------+----------------------------------------------------+
|  zptr  | 1 |   Real   |zwraca wartość wskaźnika ZPTR danego widma          |
+--------+---+----------+----------------------------------------------------+