12.3.1 Type term_t: a reference to a Prolog term
AllApplicationManualNameSummaryHelp

  • 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_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.