ForeignPointerArrayType -- foreign type for NULL-terminated arrays of pointers

Description

This is the class for a particular kind of array type, where the entries of each array are some sort of pointer type and the lengths are arbitrary. There are two built-in types, charstarstar (for arrays of strings) and voidstarstar (for arrays of pointers), but more types may be constructed using foreignPointerArrayType.

i1 : charstarstar {"foo", "bar", "baz"}

o1 = {foo, bar, baz}

o1 : ForeignObject of type char**

i2 : charstarstar {"the", "quick", "brown", "fox", "jumps", "over", "the",
         "lazy", "dog"}

o2 = {the, quick, brown, fox, jumps, over, the, lazy, dog}

o2 : ForeignObject of type char**

i3 : voidstarstar {address int 0, address int 1, address int 2}

o3 = {0x7fec26a5dc80, 0x7fec26a5dc70, 0x7fec26a5dc60}

o3 : ForeignObject of type void**

Foreign pointer arrays may be subscripted using _.

i4 : x = charstarstar {"foo", "bar", "baz"}

o4 = {foo, bar, baz}

o4 : ForeignObject of type char**

i5 : x_1

o5 = bar

o5 : ForeignObject of type char*

i6 : x_(-1)

o6 = baz

o6 : ForeignObject of type char*

Their lengths may be found using length.

i7 : length x

o7 = 3

They are also iterable.

i8 : i = iterator x;

i9 : next i

o9 = foo

o9 : ForeignObject of type char*

i10 : next i

o10 = bar

o10 : ForeignObject of type char*

i11 : scan(x, print)
foo
bar
baz

Functions and methods returning a foreign array type :

foreignPointerArrayType -- construct a foreign pointer array type

Methods that use a foreign array type :

ForeignPointerArrayType VisibleList -- cast a Macaulay2 list to a foreign pointer array

Fixed objects of class `ForeignPointerArrayType` :

"charstarstar"
"voidstarstar"

For the programmer