labels                package:memisc                R Documentation

_V_a_l_u_e _L_a_b_e_l_s

_D_e_s_c_r_i_p_t_i_o_n:

     Value labels associate character labels to possible values of an
     encoded survey item. Value labels are represented as objects of
     class "value.labels".

     Value labels of an item can be obtained using 'labels(x)' and can
     be associated to items and to vectors using labels(x) <- value

     Value labels also can be updated using the  '+' and '-' operators.

_U_s_a_g_e:

     labels(object,...)
     labels(x) <- value

_A_r_g_u_m_e_n_t_s:

  object: any object.

     ...: further arguments for other methods.

       x: a vector or "item" object.

   value: an object of class "value.labels" or a vector that can be
          coerced into an "value.labels" object or NULL

_E_x_a_m_p_l_e_s:

       x <- as.item(rep(1:5,4),
           labels=c(
               "First"      = 1,
               "Second"     = 2,
               "Third"      = 3,
               "Fourth"     = 4,
               "Don't know" = 5
             ),
           missing.values=5,
           annotation = c(
             description="test"
           ))
       labels(x)
       labels(x) <- labels(x) - c("Second"=2)
       labels(x)
       labels(x) <- labels(x) + c("Second"=2)
       labels(x)

       puvl <- getOption("print.use.value.labels")
       options(print.use.value.labels=FALSE)
       x
       options(print.use.value.labels=TRUE)
       x
       options(print.use.value.labels=puvl)

