ScriptString_pcOutChars function (usp10.h)

Article
02/22/2024

Returns a pointer to the length of a string after clipping.

Syntax

const int * ScriptString_pcOutChars(
  [in] SCRIPT_STRING_ANALYSIS ssa
);

Parameters

[in] ssa

A SCRIPT_STRING_ANALYSIS structure for the string.

Return value

Returns a pointer to the length of the string after clipping if successful. The length is the number of Unicode code points. The function returns NULL if it does not succeed.

Remarks

To use this function, the application needs to specify SSA_CLIP in its original call to ScriptStringAnalyse.

The pointer returned by this function is valid only until the application passes the associated SCRIPT_STRING_ANALYSIS structure to ScriptStringFree.

Important Starting with Windows 8: To maintain the ability to run on Windows 7, a module that uses Uniscribe must specify Usp10.lib before gdi32.lib in its library list.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	usp10.h
Library	Usp10.lib
DLL	Usp10.dll
Redistributable	Internet Explorer 5 or later on Windows Me/98/95