1.11.6 The class PlTerm_string

A SWI-Prolog string represents a byte-string on the global stack. Its lifetime is the same as for compound terms and other data living on the global stack. Strings are not only a compound representation of text that is garbage-collected, but as they can contain 0-bytes, they can be used to contain arbitrary C-data structures. However, it is generally preferred to use blobs for storing arbitrary C-data structures (see also PlTerm_pointer(void *ptr)).

PlTerm_string :: PlTerm_string(const wchar_t *text)

PlTerm_string :: PlTerm_string(const char *text)

Create a SWI-Prolog string object from a 0-terminated C-string. The text is copied.

PlTerm_string :: PlTerm_string(const wchar_t *text, size_t len)

PlTerm_string :: PlTerm_string(const char *text, size_t len)

Create a SWI-Prolog string object from a C-string with specified length. The text may contain 0-characters and is copied.