.-
help for ^unlabeld^                                              (STB-37: dm47)
.-

Describes whether value-label mappings are complete
---------------------------------------------------

     ^unlabeld^ [varlist] [^if^ exp] [^in^ range] [^, a^ny ^i^ncompl]


Description
-----------

^unlabeld^ reports whether label mappings for variables are incomplete, i.e., 
some non-missing values of the variable are not value-labeled. If incomplete,
^unlabeld^ lists the unlabeled values. In addition, ^unlabeld^ reports the 
number of distinct non-missing values.

Note that nearly the same information is contained in the output of ^codebook^,
but spread out and hidden over many pages of output.


Options
-------

^any^ specifies that variables without associated value labels are included in 
    the table along with the number of distinct values of the variable. If 
    there are only a few values, it may be useful to add value labels.

^incompl^ specifies that only reports on variables with incomplete value label
    mappings are to be displayed.


Examples
--------

        . ^unlabeld price-weight^
        . ^unlabeld, inc^

^unlabeld^ returns the number of variables with incomplete value label mappings
in the global macro ^S_1^. Thus, we can check for the completeness of variable 
labels in a data verification file using

        . ^quietly unlabeld^
        . ^assert $S_1==0^


Author
------

     Jeroen Weesie
     Utrecht University
     Netherlands
     weesie@@weesie.fsw.ruu.nl


Also See
--------

    STB:  STB-37 dm47
 Manual:  [R] label
On-line:  help for @codebook@ and @label@