aBSP开发指南.docx
- 文档编号:29977333
- 上传时间:2023-08-03
- 格式:DOCX
- 页数:66
- 大小:48.15KB
aBSP开发指南.docx
《aBSP开发指南.docx》由会员分享,可在线阅读,更多相关《aBSP开发指南.docx(66页珍藏版)》请在冰豆网上搜索。
aBSP开发指南
保密等级
大赛复赛地方内部限制
文档编号
BSP-AD0102-PM
文件管理部门
BSP
修订日期
2020-07-19
版本号
V1.00
4355BSP开发指南
修订人签字:
审核人签字:
批准人签字:
我
三
日期:
2020-07-19
李
日期:
2020-07-198
王弋
日期:
2020-07-199
华信永道(北京)科技有限公司
Yondervision(Beijing)technologyCompanyLimited
变更履历
序号
变更日期
版本
变更位置
变更内容
变更原因
批准人
审核人
修订人
1.
2012-04-10
V0.10
全文
新建
刘逍
2.
2012-06-21
V0.20
库表操作函数
增加Update_表名函数、更新宿主变量与结构体变量赋值函数解释
更新
刘逍
3.
2012-07-05
V0.30
异常处理
修改CALLERR、CALLERR_EXIT宏的调用。
更新
刘逍
4.
2012-8-13
V0.40
3.5数据库操作函数之BSPOpenDb()
修改功能描述
更新
李宏伟
5.
2012-8-15
V0.50
2全局变量说明
删除g_acHostBank、g_acSubBank、g_acFinancialDate
增加g_acAccSetId、g_acCurrAccPer
李宏伟
6.
2020-07-19
V1.00
全文
王弋
李宏伟
刘逍
7.
8.
9.
10.
11.
1文档介绍
1.1文档目的
为了帮助业务系统开发人员熟练使用业务服务平台提供的各项功能,使得系统开发过程中能够做到规范、准确,特编写本指南。
1.2文档范围
本指南对使用BSPStudio进行基于业务服务平台上的业务系统开发部分进行描述和说明,前端开发部分请参考其他有关文档。
1.3读者对象
所有参与基于业务服务平台上的业务系统开发、维护人员。
2全局变量说明
BSP平台提供以下全局变量,可在应用系统中直接使用,需要注意的是只有在备注中注明可以赋值的全局变量才可以在应用中赋值。
字段名
类型
长度
描述
备注
g_acCenterId
char
8
客户代码
g_acTranCode
char
6
交易码
g_acTranDate
char
10
交易日期
g_acSTimeStamp
char
30
交易发起时间戳
g_acMTimeStamp
char
30
渠道平台时间戳
g_acBrcCode
char
9
机构号
g_acTellCode
char
6
操作员
g_acChkCode
char
6
复核员
g_acAuthCode1
char
6
授权员一
g_acAuthCode2
char
6
授权员二
g_acAuthCode3
char
6
授权员三
g_acTranChannel
char
2
交易渠道
第一位:
交易来源
0:
柜面
1:
网站
2:
客服中心
3:
查询机
4:
网上营业厅
5:
银行
6:
其他
b:
业务系统周期批量主控
f:
财务系统周期批量主控
m:
管理系统周期批量主控
g_acTranIP
char
15
交易发起方IP
g_acAuthFlag
char
1
授权标志
可以赋值
0-正常
1-已授权
9-需要授权
g_lChnlSeq
int
渠道流水号
柜面交易时存放的是实例号
g_acAccSetId
char
2
当前账套
适用于财务周期批量(财务结账)交易。
g_acCurrAccPer
char
10
当前会计期间
适用于财务周期批量(财务结账)交易。
g_acRspCode
char
6
响应码
可以赋值
g_acRspMsg
char
80
响应信息
可以赋值
g_acNoteMsg
char
80
提示信息
可以赋值
g_lTranSeq
int
交易流水号
g_acOppOperList
char
100
交易柜员列表
g_cRcvFileFlag
char
1
接收文件标志
0-无文件1-有文件
g_acRcvFileList
char
200
接收到的文件名列表
多个文件时以“+”为分隔符
g_cSndFileFlag
char
1
发送文件标志
1-无文件1-有文件
可以赋值
g_acSndFileList
char
200
要发送的文件名列表
多个文件时以“+”为分隔符可以赋值
g_cHasError
char
1
规则检查错误标志
0-无错误1-有错误
可以赋值为YES或NO
g_acErrMsg
char
500
错误信息
可以赋值
g_lBusiSeq
int
业务流水号
g_acAccBrcCode
char
9
核算机构
由公共组件进行赋值,日终交易不适用
g_acMngBrcCode
char
9
管理机构
由公共组件进行赋值,日终交易不适用
g_acSumBrcCode
char
9
汇总机构
由公共组件进行赋值,日终交易不适用
g_acClrBrcCode
char
9
清算机构
由公共组件进行赋值,日终交易不适用
3平台函数说明
3.1返回值
平台所有函数返回0时代表函数执行成功,非0时代表函数执行失败。
3.2字符串处理函数
3.2.1BSPMemcpy–按指定内存区域拷贝字符串
函数原型:
intBSPMemcpy(void*dst,constvoid*sou,size_tlen)
功能描述:
拷贝sou指向的内存区域len字节到dst指向的内存区域(等同于函数memcpy)
调用示例:
BSPStrcpy(sou,"yondervision");
len=3;
BSPMemcpy(dst,sou,len);
执行结果:
dst="yon"
3.2.2BSPStrcpy–字符串拷贝
函数原型:
intBSPStrcpy(char*dst,constchar*sou)
功能描述:
拷贝字符串sou到dst(等同于函数strcpy)
调用示例:
BSPStrcpy(sou,"YONDERVISION");
BSPStrcpy(dst,sou);
执行结果:
dst="YONDERVISION"
3.2.3BSPStrncpy–按字节数拷贝字符串
函数原型:
intBSPStrncpy(char*dst,constchar*sou,size_tsize)
功能描述:
拷贝字符串sou的前size个字节到字符串dst(等同于函数strncpy)
调用示例:
BSPStrcpy(dst,"YONDERVISION");
BSPStrcpy(sou,"yondervision");
size=3;
BSPStrncpy(dst,sou,size);
执行结果:
dst="yonDERVISION"
3.2.4BSPStrcat–连接两个字符串
函数原型:
intBSPStrcat(char*dst,constchar*sou)
功能描述:
将字符串sou连接到字符串dst后(等同于函数strcat)
调用示例:
BSPStrcpy(dst,"abcdooo");
BSPStrcpy(sou,"dhc永道yondervision");
BSPStrcat(dst,sou);
执行结果:
dst="abcdooodhc永道yondervision"
3.2.5BSPStrncat–按字节数连接字符串
函数原型:
intBSPStrncat(char*dst,constchar*sou,size_tsize)
功能描述:
将字符串sou的前size个字节连接到字符串dst后(等同于函数strncat)
调用示例:
BSPStrcpy(dst,"YONDERVISION");
BSPStrcpy(sou,"yondervision");
size=3;
BSPStrncat(dst,sou,size);
执行结果:
dst="YONDERVISIONyon"
3.2.6BSPStrtod–将字符串转换为双精度型数字
函数原型:
intBSPStrtod(constchar*str1,double*com)
功能描述:
将字符串strl转换为double型数字,结果放入*com中(等同于函数strtod)。
调用示例:
doublecom=0.00;
BSPStrcpy(str1,"3.1415936");
BSPStrtod(str1,&com);
执行结果:
com=3.141594
3.2.7BSPStrtol–将字符串转换为整形数字
函数原型:
intBSPStrtol(constchar*str1,int*com)
功能描述:
将字符串strl转换为int型数字,结果放入*com中(等同于函数strtol)。
调用示例:
intcom=0;
BSPStrcpy(str1,"61017891");
BSPStrtol(str1,&com);
执行结果:
com=61017891
3.2.8BSPStrtoul–将字符串转换为无符号整形数字
函数原型:
intBSPStrtoul(constchar*str1,unsignedint*com)
功能描述:
将字符串strl转换为unsignedint型数字,结果放入*com中(等同于函数strtoul)。
调用示例:
charstr1[10];
intcom=0;
memset(str1,0x00,sizeof(str1));
BSPStrcpy(str1,“12345”);
BSPStrtoul(str1,&com);
执行结果:
com=12345
3.2.9BSPComp–比较两字符串是否相同
函数原型:
intBSPComp(constchar*str1,constchar*str2,int*com)
功能描述:
比较字符串str1和str2是否相同,结果放入*com中,相同时*com=1,不相同时*com=0
调用示例:
intcom=0;
BSPStrcpy(str1,"yondervision");
BSPStrcpy(str2,"YONDERVISION");
BSPComp(str1,str2,&com);
执行结果:
com=0
3.2.10BSPStrncmp–按字节数比较两字符串是否相同
函数原型:
intBSPStrncmp(constchar*str1,constchar*str2,size_tsize,int*com)
功能描述:
比较字符串str1和str2的前size个字节是否相同,结果放入*com中,相同时*com=1,不相同时*com=0。
调用示例:
intcom=0;
intsize=3;
BSPStrcpy(str1,"yondervision");
BSPStrcpy(str2,"YONDERVISION");
BSPComp(str1,str2,size,&com);
执行结果:
com=0
3.2.11BSPStrchr–在字符串中从左至右找字符出现第一个位置
函数原型:
intBSPStrchr(constchar*sou,intcom,char**dst)
功能描述:
在字符串sou中从左往右找字符com出现的第一个位置,dst指向该位置
调用示例:
char*dst;地地道道
charcom=‘#’;
BSPStrcpy(sou,"dhc#yondervision#pkg#bsp");
BSPStrcpy(sou,com,&dst);
执行结果:
dst=#yondervision#pkg#bsp
3.2.12BSPStrrchr-在字符串中从右至左找字符出现第一个位置
函数原型:
intBSPStrrchr(constchar*sou,intcom,char**dst)
功能描述:
在字符串sou中从右往左找字符com出现的第一个位置,dst指向该位置。
调用示例:
char*dst;
charcom=‘#’;
BSPStrcpy(sou,"dhc#yondervision#pkg#bsp");
BSPStrcpy(sou,com,&dst);
执行结果:
dst=#bsp
3.2.13BSPStrstr-在字符串中1从左至右找字符串2出现第一个位置
函数原型:
intBSPStrstr(constchar*str1,constchar*str2,char**dst)
功能描述:
在字符串str1中从左往右找字符串str2出现的第一个位置,dst指向该位置。
调用示例:
char*dst;
BSPStrcpy(str1,"abcdooo");
BSPStrcpy(str2,"oo");
BSPStrstr(str1,str2,&dst);
执行结果:
dst=ooo
3.2.14BSPStrpbrk-在字符串中找字符集最先出现的位置
函数原型:
intBSPStrpbrk(constchar*str1,constchar*str2,char**dst)
功能描述:
在串str1中查找给定字符集str2中的字符最先出现的位置,dst指向该位置。
调用示例:
char*dst
BSPStrcpy(str1,"dhc#yondervision#pkg#bsp");
BSPStrcpy(str2,"yon");
BSPStrpbrk(str1,str2,&dst);
执行结果:
str=yondervision#pkg#bsp
3.2.15BSPStrlen–计算字符串长度
函数原型:
intBSPStrlen(constchar*str1,size_t*len)
功能描述:
计算串str1的长度,结果放入*len中。
调用示例:
intlen=0;
BSPStrcpy(str1,"YONDERVISION");
BSPStrlen(str1,&len);
执行结果:
len=12
3.2.16BSPSplitFields–在字符串按指定个数分隔符获取数据
函数原型:
BSPSplitFields(char*sou,charsplit,intnum,char*dst)
功能描述:
在字符串sou中获得第num分隔符前的数据放入到字符串dst中
参数:
sou:
字符串
split:
分隔符
num:
第几个分隔符>=1
dst:
返回数据
调用示例
intnum=3;
chardst[100];
charslqit=‘#’
BSPStrcpy(sou,"dhc#yondervision#pkg#bsp");
BSPSplitFields(sou,sqlit,num,dst);
执行结果:
dst="pkg"
3.2.17BSPSplitFieldByStr–在字符串按指定个数分隔字符串获取数据
函数原型:
BSPSplitFieldByStr(constchar*sou,intnum,char*splitstr,char*dst)
功能描述:
在字符串sou中获得第num分隔字符串前的数据放入到字符串dst中
参数:
sou:
字符串
splitstr:
分隔字符串
num:
第几个分隔符>=1
dst:
返回数据
调用示例
intnum=3;
chardst[100];
charsplitstr[4];
BSPStrcpy(sou,"dhc@|$yondervision@|$pkg@|$bsp");
BSPStrcpy(splitstr,"@|$");
BSPSplitFieldByStr(sou,num,sqlit,dst);
执行结果:
dst="pkg"
3.2.18BSPLTrim–过滤字符串左空格
函数原型:
intBSPLTrim(char*s)
功能描述:
滤掉字符串s的左面空格
调用示例:
BSPStrcpy(s,"yondervision");
BSPLTrim(s);
执行结果:
s="yondervision"
3.2.19BSPRTrim–过滤字符串右空格
函数原型:
intBSPRTrim(char*s)
功能描述:
滤掉字符串s的右面空格
调用示例:
BSPStrcpy(s,"yondervision");
BSPRTrim(s);
执行结果:
s="yondervision"
3.2.20BSPTrim–过滤字符串左右空格
函数原型:
intBSPTrim(char*s)
功能描述:
滤掉字符串s的左右空格。
调用示例:
BSPStrcpy(s,"yondervision");
BSPTrim(s);
执行结果:
s="yondervision"
3.2.21BSPLTrimFill–过滤字符串左面指定字符
函数原型:
intBSPLTrimFill(char*s,charfill)
功能描述:
滤掉字符串s的左填充字符fill
调用示例:
charfill=‘o’;
BSPStrcpy(s,"oooabcd");
BSPLTrimFill(s,fill);
执行结果:
s="abcd"
3.2.22BSPRTrimFill–过滤字符串右面指定字符
函数原型:
intBSPRTrimFill(char*s,charfill)
功能描述:
滤掉字符串s的右填充字符fill
调用示例:
charfill=‘o’;
BSPStrcpy(s,"abcdooo");
BSPRTrimFill(s,fill);
执行结果:
s="abcd"
3.2.23BSPTrimFill–过滤字符串左右面指定字符
函数原型:
intBSPTrimFill(char*s,charfill)
功能描述:
滤掉字符串s的左右填充字符fill
调用示例:
charfill=‘o’;
BSPStrcpy(s,"oooooooooohahaooooooooo");
BSPTrimFill(s,fill);
执行结果:
s="haha"
3.2.24BSPLFill–将字符串左面填充字符
函数原型:
intBSPLFill(char*s,charfill,intlen)
功能描述:
串s左面用字符fill填充,填充个数为len-strlen(s)
调用示例:
charfill=‘o’;
intlen=3;
BSPStrcpy(s,"YD");
BSPLFill(s,fill,len);
执行结果:
s="oYD"
3.2.25BSPRFill–将字符串右面填充字符
函数原型:
intBSPRFill(char*s,charfill,intlen)
功能描述:
串s右面用字符fill填充,填充个数为len–strlen(s)
调用示例:
charfill=‘o’;
intlen=3;
BSPStrcpy(s,"YD");
BSPLFill(s,fill,len);
执行结果:
s="YDo"
3.2.26BSPFill–将字符串左右填充字符
函数原型:
intBSPFill(char*s,charfill,intlen)
功能描述:
串s左右两面用字符fill填充,填充个数为len–strlen(s)
调用示例:
charfill=‘o’;
intlen=3;
BSPStrcpy(s,"x");
BSPLFill(s,fill,len);
执行结果:
s="oxo"
3.2.27BSPIsNullStr–检查字符串是否为空
函数原型:
intBSPIsNullStr(char*str,int*com)
功能描述:
检查字符串str是否为空,为空时*com=1,否则*com=0
调用示例:
charstr[100];
intcom=0;
memset(str,0x00,sizeof(str));
BSPIsNullStr(str,&com);
执行结果:
com=1
3.2.28BSPCalKey–统计字符串中指定字符个数
函数原型:
intBSPCalKey(constchar*str1,intcom,int*count)
功能描述:
统计单个字符com在串str1中个数,结果放入*count中
调用示例:
charcom=‘o’;
intcount=0;
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- aBSP 开发 指南
![提示](https://static.bdocx.com/images/bang_tan.gif)