search definitions



p4_also_ : ALSO ( -- )

a DUP on the search ORDER - each named vocabulary replaces the topmost ORDER vocabulary. Using ALSO will make it fixed to the search-order. (but it is not nailed in trap-conditions as if using DEFAULT-ORDER )
 order:   vocn ... voc2 voc1 -- vocn ... voc2 voc1 voc1

reference: ../src/search.c:0129

p4_default_order_ : DEFAULT-ORDER ( -- )

nail the current search ORDER so that it will even survive a trap-condition. This default-order can be explicitly loaded with RESET-ORDER

reference: ../src/search.c:0198

p4_definitions_ : DEFINITIONS ( -- )

make the current context-vocabulary the definition-vocabulary, that is where new names are declared in. see ORDER

reference: ../src/search.c:0039

p4_forth_wordlist_ : FORTH ( -- voc )

return the voc-address of the base FORTH-vocabulary

reference: ../src/search.c:0216

p4_get_current_ : GET-CURRENT ( -- voc )

return the current definition vocabulary, see DEFINITIONS

reference: ../src/search.c:0047

p4_get_order_ : GET-ORDER ( -- vocn ... voc1 n )

get the current search order onto the stack, see SET-ORDER

reference: ../src/search.c:0055

p4_only_RT_ : ((ONLY)) ( -- )

the only-vocabulary is special. Calling it will erase the search ORDER of vocabularies and only allows to name some very basic vocabularies. Even ALSO is not available.
 example:
   ONLY FORTH ALSO EXTENSIONS ALSO DEFINITIONS

reference: ../src/search.c:0147

p4_order_

reference: ../src/search.c:0158

p4_previous_ : PREVIOUS ( -- )

the invers of ALSO , does a DROP on the search ORDER of vocabularies.
 order: vocn ... voc2 voc1 -- vocn ... voc2 
 example: ALSO PRIVATE-VOC DEFINTIONS (...do some...) PREVIOUS DEFINITIONS

reference: ../src/search.c:0180

p4_reset_order_ : RESET-ORDER ( -- )

load the DEFAULT-ORDER into the current search ORDER - this is implicitly done when a trap is encountered.

reference: ../src/search.c:0208

p4_search_wordlist_ : SEARCH-WORDLIST ( str-ptr str-len voc -- 0 | xt 1 | xt -1 )

almost like FIND or (FIND) -- but searches only the specified vocabulary.

reference: ../src/search.c:0070

p4_set_current_ : SET-CURRENT ( voc -- )

set the definition-vocabulary. see DEFINITIONS

reference: ../src/search.c:0089

p4_set_order_ : SET-ORDER ( vocn ... voc1 n -- )

set the search-order -- probably saved beforehand using GET-ORDER

reference: ../src/search.c:0098

p4_wordlist_ : WORDLIST ( -- voc )

return a new vocabulary-body for private definitions.

reference: ../src/search.c:0115