LPC学习笔记

LPC Tutorial

从lpc-tutorial下载tutorial，通过阅读教程来学习LPC。

关于LPC

LPC被发明出来是一个用于LPMUD的解释性语言。LPMUD其实就是一个游戏服务器，那么就很清楚了LPC是一个用来写游戏服务器的脚本语言。

LPC这个名字暗示了和C语言的联系。当然两者之间是有区别的，后面会渐次展开来讲。

LPC游戏解析

一个LPC游戏可以划分为三个部分：游戏驱动、mudlib、domain code。

游戏驱动：运行于主机上的程序。基本的对象管理核心和解释器。它被用来理解LPC语言并执行这些指令。

mudlib：LPC对象的集合。其中包含了基本的游戏环境。mulib里面的对象是最基本的游戏元素，比如玩家、怪物、房子等等。

domain code：???

语法入门

啥都别说了，看代码。

while语句
while (test) 
    statement;

if语句
if (this)
{
    statement;
}
else if (that)
{
    another_statement;
}
else
{
    default_statement;
}

定义变量
int a, b, c;

for循环：
for (a = 0; a < 10; a++)
{
    b = function_call(a, b * 2);
    c = b * 3 / 4;
}

空语句循环：
while (!(var = func(var)))
    ;

for循环:
for (i = 0; i < 100; i++);
{
    
}

定义方法：
public void
my_function(int a, int b)
{
    < code >
}

文件头注释：
/*
 * 
 *
 * 
 * 
 * Copyright (C): 
 *
 */

函数注释：    
/* 
 * 
 *
 * Arguments:     
 * Returns:       
 */

LPC基本语言概念

LPC不是编译型的，而是解释型的语言。

每次运行都被会重新解释为机器语言。

其实这意味我们写的是一种间接语言，通过特定的解释器执行特定的机器语言。

LPC语言的文件都是以.c为后缀的。文件名全部小写，如果文件里面含有多个单词，用下划线_把单词隔开。

LPC基本语法

注释

// This is a comment stretching to the end of the line.

/* This is an enclosed comment */ 

数据类型

void:nothing

int:the range -2147483648 to 2147483647.

float:range 1.17549435e-38 to 3.40282347e+38. 

string:such as "hallo world!"

mapping:key value pair.

object:references to LPC programs loaded into memory.

function:LPC functions.

array:all of things

mixed:all of type

变量声明

    int        counter;
    float      height, weight;
    mapping    age_map;

    int        counter = 8;
    float      height = 3.0, weight = 1.2;
    mapping    age_map = ([]);
    object     *monsters = ({});

基本上语法和pike是差不多的，如果还没入门最好先去看看pike。pike学习笔记

如果没有为变量赋初值，那么变量会被赋值为0，相当于其他语言的null，一般来说都不是我们希望看到的，所以哪怕赋值为空都好过没有。

方法声明

/*
 * Compute the diameter of a circle given the circumference.
 *
 * Variables:     surf_area - the surface area
 *                name - the name given the circle
 * Returns:       The circumference.
 */
float
compute_diam(float surf_area, string name)
{
    float rval;
        
    // Circumference = pie * diameter
    rval = surf_area / 3.141592643;
    write("The diameter of " + name + " is " + ftoa(rval) + "\n");

    return rval;
}

基本上对照上面的例子就知道怎么去声明和定义一个方法了。

语句和表达式

就是一些算数、布尔、条件、比较操作符。跟pike差不多，不赘述了。

比较特别的是：
The statement 'a = 1, 2, 3;' will set 'a' to contain '1'.

一般我们写if语句都这样写：

if (name == "fatty")
{
    nat = "se";
    desc = "blimp";
}
else if (name == "plugh")
{
    nat = "no";
    desc = "warlock";
}
else if (name == "olorin")
{
    nat = "de";
    desc = "bloodshot";
}
else
{
    nat = "x";
    desc = "unknown";
}

更好的选择其实是使用switch语句：

switch (name)
{
case "fatty":
    nat = "se";
    desc = "blimp";
    break;

case "plugh":
    nat = "no";
    desc = "warlock";
    break;

case "olorin":
    nat = "de";
    desc = "bloodshot";
    break;

default:
    nat = "x";
    desc = "unknown";
}

省了很多括号，而且更加清晰明了。

多用三元符号代替if-else语句：

int max(int a, int b)
{
    if(a > b)
        return a;
    else
        return b;
}

int max(int a, int b)
{
    a > b ? a:b;
}

优先级可以去查表：lpc优先级查找

普通的循环语句就不再赘述了。

array

可以通过下面的方式声明array:

    int *my_arr, *your_arr;
    float *another_arr;
    object *ob_arr;

    my_arr = ({})

虽然我觉得这种方式不太好。

可以声明一个固定大小的array：

you_arr = allocate(3);  // => your_arr = ({ 0, 0, 0 }); 

此外，如何想要在array后面或者前面添加元素，可以这样：

int a = 3;
int *b = ({1,2});
b = b + ({a});

甚至还能切片,切片始终返回一个array：

my_arr = ({ 9, 3, 5, 10, 3 });
my_arr = my_arr[0..0] + my_arr[2..4]; // => ({ 9, 5, 10, 3 })

mapping

mapping就是键值对序列。

声明一个mapping：

mapping my_map;

使用mapping的方法和pike一致。

比较特别的是，如果想删除mapping内的数据，可以用这个:

my_map = m_delete(my_map, "bertil");
my_map = m_delete(my_map, "david");

此外，如果查找一个不存在的键值对，不会报错，而是返回0.

预处理

预处理并不属于LPC语言的一部分。在编译为可执行程序之前，预处理会将替换好所有的特定字符串。

导入源文件

当我们需要一些其他源代码文件提供的函数时，我们可以通过下面的方式来导入：

#include 
#include "special_file"

#include 
#include 

#include "/d/Genesis/login/login.h"
#include "my_defs.h"
#include "/sys/adverbs.h"    // Same as the shorter one above

基本上和C语言导入源文件是一样的。

宏定义

偶尔我们会需要用字符串来代替数字或者表达式，比如说：

#define MAX_LOGIN  100          /* Max logged on players */
#define LOGIN_OB   "/std/login" /* The login object      */
#define GREET_TEXT "Welcome!"   /* The login message     */

一般来说，不建议写宏。因为宏是无类型的，而且会在异常时无法确定到底是哪个地方出了问题。建议使用常量来代替宏，记得宏之所以还存在完全是为了向下兼容。

#if, #ifdef, #ifndef, #else and #elseif

直接看代码吧：

#if CODE_VAR == 2
    
#else
    
#endif

#define CODE_VAR    /* This defines the existence of CODE_VAR */
#ifdef CODE_VAR
    
#else
    
#endif
#ifndef CODE_VAR
    
#else
    
#endif

感觉用这些有硬编码的感觉，会增加理解代码的难度，所以不推荐使用。

进阶篇

打印

1、write：自然不用在赘述了，相当于printf。
2、dump_array:打印一个array所有值，调试的时候挺有用的。注意，pike里没有这个函数。

函数调用

各种外部函数调用方式：

    pie = math_ob->compute_pie(1.0);
    pie = "/d/Mydom/thewiz/math_ob"->compute_pie(1.0);
    pie = call_other(math_ob, "compute_pie", 1.0);
    pie = call_other("/d/Mydom/thewiz/math_ob", "compute_pie", 1.0);

虽然后面三种也能调用函数，但是这种代码的可读性太低了，完全应该忘掉。

再来看看实际应用时的情况：

    object *people, *names;
    mapping hp_map;

    // Get a list of all players.
    people = users();

    // Get their names.
    names = people->query_real_name();

    // Make a mapping to call with. Item = name:pointer
    hp_map = mkmapping(names, people)

    // Replace the pointers with hit point values.
    hp_map = hp_map->query_hp();

    // All this could also have been done simpler as:
    hp_map = mkmapping(users()->query_real_name(), users()->query_hp());

如何继承一个对象类？

inherit "";

// 比如说
inherit "/std/door";
inherit "/std/room.c";

//栗子
void
my_func()
{
    /* 
     * This function exists in the parent, and I need to
     * call it from here.
     */
    ::my_func();        // Call my_func() in the parent.
}

检测变量类型

由于变量可能是0或者任意类型的东西，往往需要自己对变量做类型检查。

@bullet{int intp(mixed)}
Test if given value is an integer
@bullet{int floatp(mixed)}
Test if given value is a float
@bullet{functionp(mixed)}
Test if given value is a function pointer
@bullet{int stringp(mixed)}
Test if given value is a string
@bullet{int objectp(mixed)}
Test if given value is an object pointer
@bullet{int mappingp(mixed)}
Test if given value is a mapping
@bullet{int pointerp(mixed)}
Test if given value is an array

类型限定符

static 变量：静态的全局变量，声明一次之后一直存在

static 函数：只能内部访问，外部是不可见的

private 变量或函数：不被继承，只能对象内部访问

normal 变量或函数：can not be mask?

public 变量或函数:默认的限定符，任何成员都可访问内部对象

varargs 函数：可变参数数量的，按顺序对参数赋值，如果没有则默认赋值为0。

函数类型

函数也可以作为一个变量。

function my_func, *func_array;

my_func = allocate;
my_func = &allocate();

int *i_arr;
i_arr = allocate(5);  // Is the same as...
i_arr = my_func(5);   // ... using the function assignment above.

通过这种方式给函数重命名。

switch case

LPC的switch case支持int范围：

  switch (i)
    {
    case 0..4:
        write("Try again, sucker!\n");
        break;

    case 5..6:
        write("Congrats, third prize!\n");
        break;

    case 7..8:
        write("Yes! Second prize!\n");
        break;

    case 9:
        write("WOOOOPS! You did it!\n");
        break;

    default:
        write("Someone has tinkered with the wheel... Call 911!\n");
        break;
    }

catch throw

LPC和普通语言的try-catch方式捕获异常是不一样的：

int catch(function)
e.g.
    //0-fail 1-true
    if (catch(tail("/d/Relic/fatty/hidden_donut_map")))
    {
        write("Sorry, not possible to read that file.\n");
        return;
    }

throw(mixed info)
e.g.
    if (test < 5)
        throw("The variable 'test' is less than 5\n");

mapping、array 引用

LPC的mapping、array与pike一样是引用类型：

object *arr, *copy_arr;
arr = ({ 1, 2, 3, 4 });    // An array
copy_arr = arr;              // Assume (wrongly) that a copy_arr becomes
                             // a copy of arr.
// Change the first value (1) into 5.
copy_arr[0] = 5;

//如果想要一份拷贝怎么做？
copy_arr = ({ }) + arr;

LPC/Mudlib接口

感觉到这里就是要开始学习如何实际使用LPC来编程了。前面的都只是基本的语法知识。

首先介绍：/std/object.c。游戏里所有的对象都会继承这个基本类型。

其他类型有：

`/std/armour.c'
Armour of any kind
`/std/board.c'
Bulletin boards
`/std/book.c'
A book with pages you can open, turn and read
`/std/coins.c'
The base of all kinds of money
`/std/container.c'
Any object that can contain another
`/std/corpse.c'
Corpse of dead monsters/players/npcs
`/std/creature.c'
Simple living creatures, basically a mobile that can fight
`/std/domain_link.c'
Use this as a base to preload things in domains
`/std/door.c'
A door that connects two rooms
`/std/drink.c'
Any type of drink
`/std/food.c'
Any type of food
`/std/guild (directory)'
Guild related objects (the guild and the shadows)
`/std/heap.c'
Any kind of object that can be put in heaps
`/std/herb.c'
Herbs
`/std/key.c'
Keys for doors
`/std/leftover.c'
Remains from decayed corpses
`/std/living.c'
Living objects
`/std/mobile.c'
Mobile living objects
`/std/monster.c'
Monsters of any kind
`/std/npc.c'
A creature which can use 'tools', i.e. weapons.
`/std/object.c'
The base object class
`/std/poison_effect.c'
Handle effects in poison of any kind
`/std/potion.c'
Potions
`/std/receptacle.c'
Any kind of closable/lockable container
`/std/resistance.c'
Handle resistance against various kinds of things
`/std/room.c'
Any kind of room
`/std/rope.c'
Rope objects
`/std/scroll.c'
Scrolls
`/std/shadow.c'
Used as base when creating shadows
`/std/spells.c'
Spell objects, tomes etc
`/std/torch.c'
Torches/lamps etc
`/std/weapon.c'
Any kind of weapons

对象的使用

一个对象总是能够得到自己的引用：

ob = this_object()

这个就类似于C++的this指针。

对象的函数能够往前去查找调用此函数的对象(好神奇的感觉)：

p_ob = previous_object();     // The object calling this function.
pp_ob = previous_object(-2);  // The object calling the object
                                  // calling this function.

甚至还能往前找指定层数的对象。

不过这个函数只能去找外部调用，如果我们想要更牛掰的话，用这个：

object calling_object(void|int step)

用法是一样的，但是能够找内部也能找外部。

怎么去判断找到的是一个合法的东西呢？（不是一个0）用objectp(something)就好了：

    if (objectp(calling_object(-2)))
        write("Yes, an ob calling an ob calling this object exists!\n");
    else
        write("No such luck.\n");

函数类型

在LPC里面，函数function也是一种对象，或者说变量类型。

可以像这样定义一个函数指针：

function f = (: local_func :);

上面的 f　 可以用于其他程序流程或外部函数中, 如同普通的变量值:

foo(f);　 map_array( ({ 1, 2 }), f);

或者可以直接执行：

x = evaluate(f, "hi");
等同于：
x = local_func("hi");

甚至于，定义函数指针时还能指定参数：

function f = (: write, "Hello, world!\n" :); 

evaluate(f); 

显然，会输出：
Hello, world! 

如果想要调用外部对象的函数：

f = (: this_player(), ({ "query", "short" }) :)

等同于：

f = (: call_other, this_player(), "query", "short" :)　　　　　　　 /* 一个外部函数指针, 使用 call_other */ 
f = (: this_player()->query("short") :)　　　　　　　 // 有效的运算式; 请见下文.

特殊的，运算式函数指针：

evaluate( (: $1 + $2 :), 3, 4)　　　　　　　 // 返回 7.

这可以用于 sort_array, 范例如下: 
top_ten = sort_array( player_list,(: $2->query_level() - $1->query_level :) )[0..9];

不知名函数(函数内部的函数)：

void create() { 
function f = function(int x) { 
int y; 
switch(x) { 

case 1: y = 3; 
case 2: y = 5;
} 
return y - 2;
　　　 }; 
printf("%i %i %i\n", (*f)(1), (*f)(2), (*f)(3));

}