require ( object -- )
Factor handbook » The language » Vocabulary loader

Prev:	Vocabulary icons
Next:	require-when ( if then -- )

Vocabulary
vocabs

Inputs

object

a vocabulary specifier

Outputs
None

Word description
Loads a vocabulary if it has not already been loaded. Throws an error if the vocabulary does not exist on disk or in the dictionary.

Notes
To unconditionally reload a vocabulary, use reload. To reload changed source files only, use the words in Runtime code reloading.

Definition

IN: vocabs

GENERIC: require ( object -- )

Methods

USING: combinators kernel namespaces sets splitting strings
vocabs vocabs.private ;

M: string require
    [ ".private" ?tail ] 1check [ lookup-vocab not ] when [
        [
            dupd ?adjoin
            [ require-hook get ( name -- ) call-effect ]
            [ drop ] if
        ] with-requiring
    ] [ drop ] if ;


USING: accessors vocabs ;

M: vocab-link require name>> require ;


USING: accessors vocabs ;

M: vocab require name>> require ;