1 % API
   2 
   3 # Builtins
   4 
   5 # CString
   6 ## CString.as_text
   7 
   8 ```tomo
   9 CString.as_text : func(str: CString -> Text)
  10 ```
  11 
  12 Convert a C string to Text.
  13 
  14 Argument | Type | Description | Default
  15 ---------|------|-------------|---------
  16 str | `CString` | The C string.  | -
  17 
  18 **Return:** The C string as a Text.
  19 
  20 
  21 **Example:**
  22 ```tomo
  23 assert CString("Hello").as_text() == "Hello"
  24 
  25 ```
  26 ## CString.join
  27 
  28 ```tomo
  29 CString.join : func(glue: CString, pieces: [CString] -> CString)
  30 ```
  31 
  32 Join a list of C strings together with a separator.
  33 
  34 Argument | Type | Description | Default
  35 ---------|------|-------------|---------
  36 glue | `CString` | The C joiner used to between elements.  | -
  37 pieces | `[CString]` | A list of C strings to join.  | -
  38 
  39 **Return:** A C string of the joined together bits.
  40 
  41 
  42 **Example:**
  43 ```tomo
  44 assert CString(",").join([CString("a"), CString("b")]) == CString("a,b")
  45 
  46 ```