[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'System' (#rtl)

# StringToPPChar

Split string in list of null-terminated strings

## Declaration

Source position: systemh.inc line 1558

`function StringToPPChar(`
`var S: AnsiString;`
`ReserveEntries: Integer`
`):PPChar; function StringToPPChar(`
`S: PChar;`
`ReserveEntries: Integer`
`):PPChar;`

## 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

ArrayStringToPPchar |  | Concert an array of string to an array of null-terminated strings