更新日期：2024年09月11日
ifx_int8soasc() 函数将 int8 类型数值转换为 C char 类型值。
语法
mint ifx_int8soasc(int8_val, strng_val, len)
ifx_int8_t *int8_val;
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 747 -
char *strng_val;
mint len;
int8_val
指向 ifx_int8soasc() 将其值转换为文本字符串的 int8 结构的指针。
strng_val
指向 ifx_int8soasc() 放置文本字符串处的字符缓冲区的第一个字节的指针。
len
以字节计算的 strng_val 的大小，对于空终止符，为负 1。
用法
如果 int8 数值不适于放入长度 len 的字符串内，则 ifx_int8soasc() 将该数值转换为
指数计数法。如果该值仍不适合，则 ifx_int8soasc() 以星号填充字符串。 如果该数值比字
符串短，则 ifx_int8soasc() 向左对齐该数值，并用空格填充它的右边。
由于 ifx_int8soasc() 返回的字符串不是以空终止的，因此，在您打印它之前，您必须
将空字符添加到该字符串。
当您使用非缺省的语言环境（US English 之外的一种）时，ifx_int8soasc() 支持
strng_val 字符串中的非 ASCII 字符。要获取更多信息，
返回代码
0
转换成功。
-1207
被转换的值不适于放入分配了的空间内。
示例
demo 目录中的文件 int8soasc.ec 包含下列样例程序。
/*
* ifx_int8soasc.ec *
The following program converts three string
constants to INT8 types and then uses ifx_int8soasc()
to convert the INT8 values to C char type values.
*/
#include
#define END sizeof(result)
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 748 -
EXEC SQL include "int8.h";
char string1[] = "-12,555,444,333,786,456";
char string2[] = "480";
char string3[] = "5.2";
char result[40];
main()
{
mint x;
ifx_int8_t num1, num2, num3;
printf("IFX_INT8sOASC Sample ESQL Program running.\n\n");
if (x = ifx_int8cvasc(string1, strlen(string1), &num1))
{
printf("Error %d in converting string1 to INT8\n", x);
exit(1);
}
if (x = ifx_int8cvasc(string2, strlen(string2), &num2))
{
printf("Error %d in converting string2 to INT8\n", x);
exit(1);
}
if (x = ifx_int8cvasc(string3, strlen(string3), &num3))
{
printf("Error %d in converting string3 to INT8\n", x);
exit(1);
}
printf("\nConverting INT8 back to ASCII\n");
printf(" Executing: ifx_int8soasc(&num1, result, END - 1)");
if (x = ifx_int8soasc(&num1, result, END - 1))
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 749 -
printf("\tError %d in converting INT8 to string\n", x);
else
{
result[END - 1] = '\0'; /* null terminate */
printf("\n The value of the first INT8 is = %s\n", result);
}
printf("\nConverting second INT8 back to ASCII\n");
printf(" Executing: ifx_int8soasc(&num2, result, END - 1)");
if (x= ifx_int8soasc(&num2, result, END - 1))
printf("\tError %d in converting INT8 to string\n", x);
else
{
result[END - 1] = '\0'; /* null terminate */
printf("\n The value of the 2nd INT8 is = %s\n", result);
}
printf("\nConverting third INT8 back to ASCII\n");
printf(" Executing: ifx_int8soasc(&num3, result, END - 1)");
/* note that the decimal is truncated */
if (x= ifx_int8soasc(&num3, result, END - 1))
printf("\tError %d in converting INT8 to string\n", x);
else
{
result[END - 1] = '\0'; /* null terminate */
printf("\n The value of the 3rd INT8 is = %s\n", result);
}
printf("\nIFX_INT8sOASC Sample Program over.\n\n");
exit(0);
}
输出
IFX_INT8sOASC Sample ESQL Program running.
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 750 -
Converting INT8 back to ASCII
Executing: ifx_int8soasc(&num1, result, sizeof(result)-1)
The value of the first INT8 is = -12555444333786456
Converting second INT8 back to ASCII
Executing: ifx_int8soasc(&num2, result, sizeof(result)-1)
The value of the 2nd INT8 is = 480
Converting third INT8 back to ASCII
Executing: ifx_int8soasc(&num3, result, END)
The value of the 3rd INT8 is = 5