Share

AcString::tokenize

C++

AcString tokenize(
    const wchar_t* pszTokens, 
    Adesk::Int32& iStart
) const;

Description

Finds the next token in a target string.

Parameters

Parameters Description
pszTokens Input string containing token delimiters.The order of these delimiters is not important.
iStart Input zero-based index number at which to begin the search.

Returns

An AcString containing the current token value.

Remarks

Returned string does not contain the delimiter, and an empty string is returned if no more tokens or iStart is invalid.

iStart is updated to next position after the delimiter and iStart will be set to -1 if there are no more tokens. Consecutive tokens are skipped.

An empty pszTokens returns the remaining string from iStart.

Clients processing in a loop can use either an empty string or iStart == -1 to end tokenization.

Links

AcString

Previous Declaration

AutoCAD 2021 through AutoCAD 2024

ACBASE_PORT AcString tokenize(const wchar_t* pszTokens, int& iStart) const;

AutoCAD 2017 through AutoCAD 2020

ACBASE_PORT AcString tokenize(const wchar_t* pszTokens, int& iStart);

History

AutoCAD 2021 through AutoCAD 2024

iStart argument now expects an Adesk::Int32 instead of int.

AutoCAD 2021

Signature changed and is now a const.

Was this information helpful?