Python 与 Gnumeric 共舞

核心提示： 以func_bitand函数为例，函数接受两个整数，Python 与 Gnumeric 共舞(3)，返回值也为整数，C与Python的类型转换是Gnumeric自动完成的， 如func_bitand，key就是在Gnumeric被映射的函数名py_bitand，func_bitand只注重

以func_bitand函数为例，函数接受两个整数，返回值也为整数，C与Python的类型转换是Gnumeric自动完成的，func_bitand只注重算法的实现，具体计算是通过调用Gnumeric的按位求和函数（bitand）完成的；值得一提的是''@''开头的文档字符串是提供给Gnumeric的文档接口，分别提供函数的功能、接口、实例以及引用方面的信息，格式也是固定的，每个域（包括换行符）用单引号括起来并后接""。

代码 1 func_bitand函数定义

from Gnumeric import *
def func_bitand(num1, num2):
　　　　'@FUNCTION=PY_BITANDn'
　　　　'@SYNTAX=PY_BITAND (num)n'
　　　　'@DESCRIPTION=The BITAND function returns bitwise'
　　　　'and-ing of its arguments.'
　　　　'n'
　　　　'@EXAMPLES=n'
　　　　'PY_BITAND(6, 2) equals 2)'
　　　　'n'
　　　　'@SEEALSO=BITAND'
　　　　
　　　　
　　　　gnm_bitand=functions['bitand'] # Gnumeric的按位求和函数
　　　　return gnm_bitand(num1, num2)
　　　

py_func.py文件尾处还有一个起特殊作用的字典，向Gnumeric提供Python函数原型信息，姑且称之为函数原型字典。函数原型字典的命名是非常严格的，必须以"_functions"为后缀，"_"前面前面的名字必须与plugin.xml文件保持一致，这样Gnumeric才能发现插件中的各种函数信息，否则Gnumeric就会出现许多函数信息方面的错误，导致插件函数无法使用。函数原型用字典中"key:value"对来表示（代码2）， 如func_bitand，key就是在Gnumeric被映射的函数名py_bitand，value是由参数类型、参数名称、函数名称组成的元组。