[参考译文] TM4C123GH6PM：使用子串时出现 GrStringGet 错误

这是我的 GrStringGet()的修改版本：

//
//
//！ 此函数从当前字符串表返回字符串。
//！
//！ \param i32Index 是要检索的字符串的索引。
//！ \param pcData 是用于存储字符串的缓冲区的指针。
//！ \param ui32Size 是 pcData 提供的缓冲区的大小。
//！
//！ 此函数将从字符串表中返回一个字符串，其语言
为//！ 由 GrStringLanguageSet()函数设置。 在\e iIndex
//！中传递的值 参数是被请求的字符串、将在
//中返回！ 在\e pcData 参数中提供的缓冲区。 数据量
//！ 返回的值将受到 ui32Size 参数的限制。
//！
//！ return 返回在\e pcData 缓冲区中返回的有效字节数。
////
*****************
uint32_t
GrStringGet (int32_t i32Index、char * pcData、uint32_t ui32Size)
｛
uint32_t ui32Len、ui32Offset、ui32SubCode[16]；
int32_t i32Pos、i32Idx、i32Bit、i32Skip、i32Buf；
uint8_t * pui8BufferOut；
const uint8_t * pui8String；

assert (i32Index < g_ui16NumStrings)；
assert(pcData !=0);

//
//初始化输出缓冲器状态。
//
i32Pos = 0；
pui8BufferOut = 0；

//
//如果由另一个字符串组成，我们需要处理它
//这可以嵌套多个层，所以我们继续
//
ui32SubCode[i32Pos]= g_pui32StringTable[(g_ui16Language *
g_ui16NumStrings)+ i32Index]；

if (sc_get_LEN (ui32SubCode[i32Pos]))
｛
//
//递归
//
while (i32Pos < 16)
｛
//
//从之前的字符串复制部分(如果有)。
//
i32Idx = SC_GET_INDEX (ui32SubCode[i32Pos++])；

ui32SubCode[i32Pos]= g_pui32StringTable[(g_ui16Language *
G_ui16NumStrings)+
i32Idx]；

if (！sc_get_LEN (ui32SubCode[i32Pos]))
｛
//
//未链接，只需字符串
//
中断；
｝
}


//
//现在向后工作。
//
i32Idx = 0；

//
//将字符串分成几个部分。
//
while (i32Pos >= 0)
｛
//
//在字符串表中获取偏移量。
//
ui32Offset = SC_GET_OFF (ui32SubCode[i32Pos])；

if (ui32Offset = SC_is_NULL)
｛
//
//空字符串。
//
pcData[i32Idx]= 0；
｝
否则、IF (ui32Offset 和 SC_FLAG_COMPLEed)
｛
//
//这是一个压缩字符串，因此初始化指向的指针
//压缩数据。
//
pui8String = g_pui8StringData +(ui32Offset & SC_OFFSET_M)；

//
//初始化位变量。
//
i32Bit = 0；
i32Skip = 0；

//
//指向当前缓冲区输出位置。
//
pui8BufferOut =(uint8_t *) pcData + i32Idx；

//
//如果 OUT 缓冲区超出最大大小，则只需中断即可
//输出并返回到目前为止我们拥有的内容。
//
if ((char *) pui8BufferOut >(pcData + ui32Size))
｛
中断；
｝

//
//现在通过解压缩位来构建实数字符串。
//
if (！sc_get_LEN (ui32SubCode[i32Pos])&&
SC_GET_INDEX (ui32SubCode[i32Pos])
｛
i32Skip = SC_GET_INDEX (ui32SubCode[i32Pos])；

if (i32Pos)
｛
ui32Len = SC_GET_LEN (ui32SubCode[i32Pos - 1])；
｝
其他
｛
ui32Len =(i32Skip & 0x3f)；
｝

i32Skip >=6；
i32Idx += ui32Len；
ui32Len += i32Skip；
｝
否则 if (i32Pos)
｛
//
//获取部分字符串的长度。
//
ui32Len = SC_GET_LEN (ui32SubCode[i32Pos - 1])- i32Idx；
i32Idx += ui32Len；
｝
否则、如果(！sc_get_LEN (ui32SubCode[0])&&
SC_GET_INDEX (ui32SubCode[0])
｛
ui32Len = SC_GET_INDEX (ui32SubCode[0])；
i32Skip = ui32Len >> 6；
ui32Len =(ui32Len & 0x3f)+ i32Skip；
｝
其他
｛
//
//任意作为空字符结束字符串。
//
ui32Len = 1024；
｝

for (；ui32Len；ui32Len--)
｛
//
//为每个字符打包6位
//
*pui8BufferOut =(* pui8String >> i32Bit)& 0x3f；

if (i32Bit >= 2)
｛
*pui8BufferOut |=(*++pui8String <<(8 - i32Bit))& 0x3f；
｝

i32Bit =(i32Bit + 6)& 0x7；

if (！* pui8BufferOut)
｛
//
//字符串末尾
//
中断；
｝

if (i32Skip)(i32Skip)
｛
i32跳过--；
继续；
｝

//
//将删除的位放回
//
*pui8BufferOut |= 0x40；

//
//现在查找我们映射到其他的几个特殊字符
//字符。
//
if (* pui8BufferOut ='`')
｛
*pui8BufferOut ='；
｝
否则 if (*pui8BufferOut ='~')
｛
*pui8BufferOut ='-'；
｝
否则 if (*pui8BufferOut =0x7f)
｛
*pui8BufferOut ='.'；
}
否则，如果(*pui8BufferOut ='\')
｛
*pui8BufferOut =':'；
}

//
//增加指针，如果指针现在，则中断
//超出提供的缓冲区的末尾。
//
pui8BufferOut++；

if ((char *) pui8BufferOut >=(pcData + ui32Size))
｛
中断；
｝
}

否则 if (i32Pos)
｛
//
//另一个字符串的一部分
//
ui32Len = SC_GET_LEN (ui32SubCode[i32Pos - 1])- i32Idx；

//
//防止此副本超出缓冲区的末尾
//已提供。
//
if ((i32Idx + ui32Len)> ui32Size)
｛
ui32Len = ui32Size - i32Idx；
｝

//
//将字符串的这一部分复制到输出缓冲区。
//
for (i32Buf = 0；i32Buf < ui32Len；i32Buf++)
｛
pcData[i32Idx + i32Buf]= g_pui8StringData[ui32Offset +
i32Buf]；
｝

i32Idx += ui32Len；
｝
其他
｛
if (sc_get_index (ui32SubCode[0])&&！sc_get_LEN (ui32SubCode[0])｝
｛
//
//将字符串的这一部分复制到输出缓冲区。
//
for (i32Buf = 0；i32Buf < SC_GET_INDEX (ui32SubCode[0])；i32Buf++)
｛
if ((i32Idx + i32Buf)< ui32Size)
｛
pcData[i32Idx + i32Buf]= g_pui8StringData｝











；｛i32Idx + i32Buf]｝字符串的最后一个/｛u32Offset｝/｝次/｛i32Buf｝次/｝次/次/次/次/次/次/次/次/次/次/次/次/次/次/次
//
for (i32Buf = 0；i32Buf <(ui32Size - i32Idx)；i32Buf++)
｛
//
将字符串复制到输出缓冲区。
//
pcData[i32Idx + i32Buf]= g_pui8StringData[ui32Offset +
i32Buf]；

//
如果按 null，则终止副本。
//
if (pcData[i32Idx + i32Buf]==0)
{
break；
}

//


//如果我们在遇到这种情况之前没有复制任何字符，
//初始化输出指针(这将使代码保持在
//返回长度快乐的函数的末尾)。
如果我们使用未压缩的字符串表、这将是//情况。
//
if (！pui8BufferOut)
｛
pui8BufferOut =(uint8_t *) pcData +(i32Idx + i32Buf)；
｝


i32Pos--;
}

//
//返回复制到输出缓冲区的字节数。
//
if (pui8BufferOut)
｛
ui32Len =((uint32_t) pui8BufferOut -(uint32_t) pcData)；

//
//空如果有空间，则终止字符串。
//
if (ui32Len < ui32Size)
｛
pcData[ui32Len]= 0；
｝
｝
其他
｛
ui32Len = 0；
｝

return (ui32Len)；
｝