Sign in Join
FPDoc Onlineexperiment

StringToPPChar function

In unit System

Split string in list of null-terminated strings.

Declaration

pascal
function StringToPPChar(var S: AnsiString; ReserveEntries: Integer)
: PPAnsiChar

Description

StringToPPChar splits the string S in words, replacing any whitespace with zero characters. It returns a pointer to an array of pchars that point to the first letters of the words in S. This array is terminated by a Nil pointer.

The function does not add a zero character to the end of the string unless it ends on whitespace.

The function reserves memory on the heap to store the array of PChar; The caller is responsible for freeing this memory.

This function is only available on certain platforms.

Errors

None.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.