author: DEM0STEN
(http://demosten.com, stjordanov@hotmail.com)

Technical documentation / Техническа документация
(blah)

Цел:

Целта на Java Script интерпретатора е да даде на разработчиците на софтуер възможност да използват скрипт език в своите продукти с което да разширят тяхната функционалност. Така се дава на потребителя възможност за по-добра работа с програмния продукт.

Какво е по-различното (предимства):

Java Script интерпретатора разполага с удобен интерфейс за разработчиците даващ възможност за дефиниране както на външни функции така и на външни променливи, които след това се използват от скрипт файлове.

Прилики и разлики с езика Java Script дефиниран от Netscape:

Java Script интерпретатора е разработен въз основа на документация на Java Script версия 1.1.

Разлики с оригиналния Java Script версия 1.1 (към версия A (beta 2)):

• Вътрешно са реализирани само три вградени функции, а именно eval(), parseInt() и parseFloat(). Всички останали вградени функции и обекти като Array(), Date(), Math() и т.н. може да бъдат реализирани от разработчика по негово желание чрез външни функции (по този начин са реализирани и трите вградени функции).
• Не се разпознава оператора with(...). Може би в някоя от следващите версии, това ще бъде коригирано.
• Не се разпознава оператора <expr1>?<expr2>:<expr3>. Може би в някоя от следващите версии и това ще бъде коригирано.
• Символните променливи не са реализирани като обекти. Това означава, че не можете да използвате принадлежащите към тях функции както е дефинирано в описанието на езика.

Особености (към версия A (beta 2)):

• Всички елементи на езика се пазят в стекове. Това е направено с цел по-малък и бърз код. Като следствие при използването на оператора for (var in obj) първо ще се върнат като резултат последните присвоени членове на обекта.
• Ключовата дума ''in' е реализирана като оператор. Това води до редица особености при работа:
• възможно е реализирането на цикъл от рода на:
  for (var i=0; i in obj; )
  Този цикъл ще работи коректно, като при всяка итерация стойността на 'i' автоматично ще се увеличава!
• важна особеност е че стойността на 'i' преди използването на цикъл от вида:
  for (i in obj)
  трябва да бъде инициализирана (т.е. да и бъде присвоена стойност, която не е име на член на обекта 'obj').
• Реда на които възникват грешките по време на изпълнение (означени с 'runtime error'), най-често сочи не точния ред от изходния код, а съставния оператор в чиито блок е възникнала грешката.
• Имената на променливите са ограничени до 100 символа. Това се отнася само за име на една променлива т.е. при променливата object.method(), object не може да е по-дълго от 100 символа, method също. Това ще бъде коригирано когато намеря свободно време.

Описание на функциите които могат да се използват за управление на интерпретатора:

/*********************************************************/
int JSI_CALLBACK test(int argc, PVar argv)
{
int iCounter;
char *szValue;
double dValue;

    for (iCounter = 0; iCounter < argc; iCounter++) {
        if (JSI_GetParam(iCounter, &szValue, &dValue, argv) == varNum) {
            printf("%f", dValue);
        }
        else
            printf("%s", szValue);
    }
    return 0;
}
/*********************************************************/
int main(int argc, char *argv[])
{
    JSI_AddExtrFunction("write", test);
    return 0;
}
/*********************************************************/

static int iProba = -2;

/*********************************************************/
int JSI_CALLBACK GetMyVar(void)
{
    JSI_SetResult(NULL, (double)iProba, varNum); // това е задължително
    return 0;
}
/*********************************************************/
int JSI_CALLBACK SetMyVar(TVarType Type, char* szValue, double dValue)
{
    if (Type == varNum)
        iProba = (int)dValue;
    return 0;
}
/*********************************************************/
int main(int argc, char *argv[])
{
    JSI_AddExtrVar("ExternalVar", GetMyVar, SetMyVar);
    return 0;
}
/*********************************************************/

</край_на_файла>