扫码出入库——函数接口

一.接口函数定义

FUNCTION int login(string userID, string password) //登录操作
FUNCTION int register(string username, string userID, string password, string password_retype, string email, string phone)//注册操作
FUNCTION int forgetpassword_check (string userID, string email)  //忘记密码核验操作
FUNCTION int forgetpassword_reset (string userID, string password, string password_retype)  //忘记密码重设操作
FUNCTION int object_add (int objectID, string objectname, string addtime,string userID) //新增物品
FUNCTION int object_del (int objectID, string deltime, string userID) //删除物品
FUNCTION int object_in(int objectID, string intime, string userID) //入库
FUNCTION int object_out(int objectID, string outtime, string userID) //出库
FUNCTION int user_del(string userID) //删除用户
FUNCTION double cameraparams_add (double currentvalue) //相机参数加
FUNCTION double cameraparams_subtract (double currentvalue) //相机参数减
FUNCTION int object_ position (int objectID) //查找物体位置
FUNCTION int userinformation_read (string *username, string *userID, string *password, string *email, string *phone，int *privilege) //读取用户信息

二.接口函数说明

1.login (): 登录操作

用 法: code= login (, )

参 数: : 用户ID

​ : 用户密码

返回值: 返回值为0表示操作员登陆成功,为1表示管理员登陆成功,为2表示工程师登陆成功,为-1表示用户不存在，为-2表示密码错误。

说 明: 此函数用来登录,参数为11位数字，参数是用户密码，长度20位以内。

　　 举 例: code= login (01234567890，123456)，如果code=0表示操作员登录成功。

1. register (): 注册操作

   用 法: code= register (，，，，, < expC6>)

   参 数: : 用户名

: 用户ID

: 用户首次密码

: 用户确认密码

: 用户邮箱

: 用户手机

返回值: 返回值为0,表示注册成功，返回值为-1表示用户名为空，返回值为-2表示用户ID不合规，返回值为-3表示密码不合规，返回值为-4表示两次密码不一致，返回值为-5表示邮箱为空，返回值为-6表示手机号码为空。

说 明: 此函数用来注册，参数 为用户名，10字符以内，参数为用户ID，唯一且不重复,推荐使用手机号创建，参数为用户密码，长度20字符以内，参数为用户再次输入密码，要和一样，参数为用户邮箱，为用户手机。

举 例: code= register (laopaoer，01234567890，123456，123456，laopaoer@qq.com，01234567890)，若code=0表示注册成功。

参 见: login ()

1. forgetpassword_check(): 核验用户身份

   用 法: code= forgetpassword_check(, )

   参 数: : 用户ID

: 用户邮箱

返回值: 返回值为0,表示验证成功，为-1表示无该用户,为-2表示邮箱验证失败。

说 明: 此函数用来核验忘记密码的用户身份。

举 例: code= forgetpassword_check(01234567890,laopaoer@qq.com),如果code=0,表示用户身份验证成功。

1. forgetpassword_reset(): 重设密码

   用 法: code= forgetpassword_ reset (,,)

   参 数: : 为用户ID

​ : 为要重设密码

: 为再次输入的密码

返回值: 返回值为0,表示操作正确,-1表示密码不合规，-2表示两次密码不一致。

说 明: 此函数将用户密码重设。

举 例: code= forgetpassword_ reset (01234567890,123456,123456),code=0表示成功。

1. object_add(): 新增物品

   用 法: code= int object_add (, , , )

   参 数: 物品ID

   物品名称

   新增时间

   用户ID

   返回值: 返回值为0,表示新增成功。

   说 明: 此函数使可以增加数据库中物品。为4位整型数据，参数为字符类型，10字符以内。

   举 例: code= object_add (0001, “plc”,2022/10/10, 01234567890)，若code=0表示ID为01234567890的用户于2022/10/10成功添加ID为0001，名称为plc的物品。

1. object_del(): 删除物品

   用 法: code= object_del (,,)

   参 数: : 物品ID

​ : 操作时间

​ : 用户ID

返回值: 返回值为0,表示操作正确。

说 明: 此函数使可以删除数据库中物品，为4位整型数据。

举 例: code= object_del(0001,2022/10/10,01234567890)，若code=0表示ID为01234567890的用户于2022/10/10成功删除ID为0001的物品。

参 见: object_add()

1. object_in(): 入库物品

   用 法: code= object_in (,,)

   参 数: : 物品ID

​ : 入库时间

​ : 用户ID

返回值: 返回值为0,表示操正确。

说 明: 此函数可以入库物品，为4位整型数据，参数由函数获得。

举 例: code= object_in (0001,2022/10/10,01234567890)，若code=0表示用户01234567890在2022/10/10成功入库物品0001。

1. object_out(): 出库物品

   用 法: code= object_in (,,)

   参 数: : 物品ID

​ : 出库时间

​ : 用户ID

返回值: 返回值为0,表示操正确。

说 明: 此函数可以出库物品，为4位整型数据，参数由函数获得。

举 例: code= object_out (0001,2022/10/10,01234567890)，若code=0表示用户01234567890在2022/10/10成功出库物品0001。

参 见: object_in()

1. user_del(): 删除用户

   用 法: code= user_del ()

   参 数: : 要删除的用户ID

   返回值: 返回值为0,表示操正确。

   说 明: 此函数可以删除用户，为要删除的用户ID。

   举 例: code= user_del(01234567890),若code=0表示成功删除ID为01234567890的用户。

1. cameraparams_add (): 相机参数增加

   用 法: code= cameraparams_add ()

   参 数: : 相机参数原始值

   返回值: 返回值原始值加0.5。

   说 明: 此函数可以增加相机参数值，为浮点类型，参数由函数获得。

   举 例: code= cameraparams_add ()，可使相机参数加0.5。

1. cameraparams_subtract (): 相机参数减少

   用 法: code= cameraparams_ subtract ()

   参 数: : 相机参数原始值

   返回值: 返回值原始减少0.5。

   说 明: 此函数可以减少相机参数值，为浮点类型，参数由函数获得。

   举 例: code= cameraparams_add ()，可使相机参数减0.5。

   参 见: cameraparams_add ()

1. object_ position (): 查寻物体位置

   用 法: code= object_ position ()

   参 数: : 物品ID

   返回值: 返回物体仓库标号。

   说 明: 此函数可以查找物体位置，为物体ID，返回位置参数。

   举 例: code= object_ position(0001)，若code=10，代表0001在10号位。

1. int userinformation_read (): 读取用户信息

   用 法: code= userinformation_read (，，，，, )

   参 数: : 用户名

: 用户ID

: 用户密码

: 用户邮箱

: 用户手机

: 用户权限

返回值: 返回值为0,表示读取成功，返回值为-1表示用户名为空，返回值为-2表示用户ID为空，返回值为-3表示密码不合规，返回值为-4表示邮箱为空，返回值为-5表示手机为空，返回值为-6表示权限为空。

说 明: 此函数用来读取用户信息，参数 为用户名，该函数将读取的参数赋值给 ~，以供程序使用。

举 例: code= userinformation_read (username, userID, password, email, phone privilege)，若code=0表示读取成功。

参 见: regist ()