FSH STORECHAR: Difference between revisions
Created page with "This function provides the mechanism for storing a character into a string, taking into account DBCS considerations. ==Syntax== FSH_STORECHAR(chDBCS, ppStr) ==Parameters=..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
This function provides the mechanism for storing a character into a string, taking into account DBCS considerations. | This function provides the mechanism for storing a character into a string, taking into account DBCS considerations. | ||
==Syntax== | ==Syntax== | ||
FSH_STORECHAR(chDBCS, ppStr) | FSH_STORECHAR(chDBCS, ppStr) | ||
==Parameters== | ==Parameters== | ||
;chDBCS:is the character to be stored. This may be either a single-byte character or a double-byte character with the first byte occupying the low-order position. | |||
;ppStr:is the pointer to the character pointer where the character will be stored. This pointer is updated upon return. | |||
==Returns== | ==Returns== | ||
There are no error returns. | |||
==Calling Sequence== | ==Calling Sequence== | ||
<PRE> | <PRE> | ||
| Line 18: | Line 18: | ||
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: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate. | |||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
{{DISPLAYTITLE:FSH_STORECHAR}} | {{DISPLAYTITLE:FSH_STORECHAR}} | ||
Latest revision as of 07:07, 20 February 2020
This function provides the mechanism for storing a character into a string, taking into account DBCS considerations.
Syntax
FSH_STORECHAR(chDBCS, ppStr)
Parameters
- chDBCS
- is the character to be stored. This may be either a single-byte character or a double-byte character with the first byte occupying the low-order position.
- ppStr
- is the pointer to the character pointer where the character will be stored. This pointer is updated upon return.
Returns
There are no error returns.
Calling Sequence
int far pascal FSH_STORECHAR(chDBCS, ppStr) unsigned short chDBCS; 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.