FSH PREVCHAR: Difference between revisions
Created page with "This function provides the mechanism for decrementing a character point, taking into account DBCS considerations. ==Syntax== FSH_PREVCHAR(pBeg, ppStr) ==Parameters== ;pBe..." |
mNo edit summary |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
This function provides the mechanism for decrementing a character point, taking into account DBCS considerations. | This function provides the mechanism for decrementing a character point, taking into account DBCS considerations. | ||
==Syntax== | ==Syntax== | ||
FSH_PREVCHAR(pBeg, ppStr) | FSH_PREVCHAR(pBeg, ppStr) | ||
==Parameters== | ==Parameters== | ||
;pBeg: is a pointer to the beginning of a string. | ;pBeg: is a pointer to the beginning of a string. | ||
;ppStr: is a pointer to the character pointer of a string. | |||
:The value is decremented appropriately upon return. If it is at the beginning of a string, the pointer is not decremented. If it points to the second byte of a DBCS character, it will be decremented to point to the first byte of the character. | |||
==Returns== | |||
There are no error returns. | |||
==Calling Sequence== | ==Calling Sequence== | ||
<PRE> | <PRE> | ||
| Line 19: | Line 19: | ||
char far * far * ppStr; | char far * far * ppStr; | ||
</PRE> | </PRE> | ||
==Remarks== | ==Remarks== | ||
The FSD is responsible for verifying the string pointer and checking for segment boundaries. | The FSD is responsible for verifying the string pointer and checking for segment boundaries. | ||
;Note: | ;Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate. | ||
[[Category: | [[Category:IFS Interfaces]] | ||
{{DISPLAYTITLE:FSH_PREVCHAR}} | {{DISPLAYTITLE:FSH_PREVCHAR}} | ||
Latest revision as of 04:52, 20 February 2020
This function provides the mechanism for decrementing a character point, taking into account DBCS considerations.
Syntax
FSH_PREVCHAR(pBeg, ppStr)
Parameters
- pBeg
- is a pointer to the beginning of a string.
- ppStr
- is a pointer to the character pointer of a string.
- The value is decremented appropriately upon return. If it is at the beginning of a string, the pointer is not decremented. If it points to the second byte of a DBCS character, it will be decremented to point to the first byte of the character.
Returns
There are no error returns.
Calling Sequence
void far pascal FSH_PREVCHAR(pBeg, ppStr) char far * pBeg; char far * far * ppStr;
Remarks
The FSD is responsible for verifying the string pointer and checking for segment boundaries.
- Note
- OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate.