SWI-Prolog -- API-function PL_new_term

Documentation
- Reference manual
  - Foreign Language Interface
    - Interface Data Types
      - Type term_t: a reference to a Prolog term
        
        PL_new_term_ref()
        
        PL_new_term_refs()
        
        PL_copy_term_ref()
        
        PL_free_term_ref()
        
        PL_reset_term_refs()
        
        Interaction with the garbage collector and stack-shifter
- Packages

Availability:C-language interface function

term_t PL_new_term_ref()

Return a fresh reference to a term. The reference is allocated on the local stack. Allocating a term reference may trigger a stack-shift on machines that cannot use sparse memory management for allocation of the Prolog stacks. The returned reference describes a variable. Raise a resource exception and returns (term_t)0 on failure.