Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

ManualsBrandsHP ManualsServerHP NonStop G-Series

1111

wcstok(3) Guardian Native C Library Calls Reference Manual

NAME

wcstok - Splits wide-character strings into tokens

LIBRARY

G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL

G-series native OSS processes: /G/system/sysnn/zcrtlsrl

H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL

32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll

64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll

SYNOPSIS For TNS/E Target Compilations on H06.09 and Later RVUs

This version of the function applies to TNS/E target compilations on H06.09 and later H-series

RVUs.

#include <wchar.h>

wchar_t *wcstok(

wchar_t *ws1,

const wchar_t *ws2,

wchar_t **ptr);

SYNOPSIS For Other RVUs

This version of the function applies to TNS/R target compilations and to TNS/E target compila-

tions on H06.08 and earlier H-series RVUs.

#include <wchar.h>

wchar_t *wcstok(

wchar_t *ws1,

const wchar_t *ws2);

PARAMETERS

ws1 Contains a pointer to the wide-character string that is to be searched.

ws2 Contains a pointer to the string of wide-character token delimiters.

ptr Contains a pointer to a caller-provided wchar_t pointer into which the wcstok()

function stores information necessary for it to continue scanning the same wide-

character string. You must supply this pointer value in the ptr value of the next

call to wcstok(). Whether or not the ptr parameter is required depends on the

target compilation and the RVU the system is running:

• If the target is TNS/R or if the target is TNS/E and the system is running

H06.08 or an earlier H-series RVU, you are not required to specify the

ptr parameter.

• If the target is TNS/E and the system is running H06.09 or a later H-

series RVU, you must specify the ptr parameter. If you have an existing

object ﬁle that contains calls to wcstok(), you can continue to use the

object ﬁle. However, if you recompile existing source code, you must

change references to wcstok() to specify the ptr parameter. If you do not

specify this parameter, the compiler issues an error.

DESCRIPTION

The wcstok() function splits the wide-character string pointed to by the ws1 parameter into a

sequence of tokens, each of which is delimited by a wide character from the wide-character

string pointed to by the ws2 parameter.

7−162 Hewlett-Packard Company 527192-018