# GEOS Example Programs
* `capi_read` uses the standard C API to read two WKT geometries, calculate the intersection and print the result
* `capi_read_ts` uses the "re-entrant" C API (threadsafe) to read two WKT geometries, calculate the intersection and print the result
* `capi_prepared` uses the standard C API to read one WKT geometry, and fill it with a point grid, applying a high performance "prepared" geometry to speed up intersection testing
* `capi_strtree` uses the standard C API to build a random collection of points, and then search that collection quickly to find the nearest to a query point
* `cpp_read` uses the C++ API to read two WKT geometries, calculate the intersection and print the result
## Build
To build the examples _in situ_:
```
mkdir _build
cd _build
cmake ..
make
```
To build programs in general, you will need to ensure that the appropriate header and include files are available to the compiler. Here's a raw compile command example for a CAPI program:
```
cc -I/usr/local/include \
capi_read.c \
-o capi_read \
-L/usr/local/lib \
-lgeos_c
```
* Ensure the header files can be found by the compiler
* Ensure the library files can be found by the compiler
* Ensure the C API library is passed to the linker
To build a C++ API program, you must pass a define indicating you're OK with the fact that the API will change over time.
```
cc -I/usr/local/include \
-D USE_UNSTABLE_GEOS_CPP_API \
cpp_read.cpp \
-o cpp_read \
-L/usr/local/lib \
-lgeos
```