c('PL_get_head')

Documentation
- Reference manual
  - Foreign Language Interface
    - The Foreign Include File
      - Analysing Terms via the Foreign Interface
        
        Reading a list
        
        PL_get_list()
        
        PL_get_head()
        
        PL_get_tail()
        
        PL_get_nil()
        
        PL_skip_list()
- Packages

Availability:C-language interface function

int PL_get_head(term_t +l, term_t -h)

If l is a list and not the empty list, assign a term reference to the head to h.