getuuid                package:Ruuid                R Documentation

_F_u_n_c_t_i_o_n_s _t_o _h_a_n_d_l_e _u_n_i_q_u_e _I_D_s

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

     These functions allow a user to retrieve and transform universally
     unique ID values.  A user can get a new UUID, as well as transform
     a string representation into a byte representation and vice versa.

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

     getuuid(cur)

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

     cur: If provided, either a UUID string or a `uuidt' object

_D_e_t_a_i_l_s:

     This package uses Theodore Ts'o's libuuid to generate universally
     unique ID values.  A unique ID value is represented in R by the
     class `uuidt', which wraps the byte values.  A wrapper object is
     the most common method of handling these values, `Ruuid' - which
     also provides for a string representation of the UUID.

     If no parameter `cur' is passed into `getuuid', a new `Ruuid' is
     generated.  If either a string or a `uuidt' object is passed in,
     then the complementary piece is generated and the resultant
     `Ruuid' is generated.

_V_a_l_u_e:

     getuuid:  Returns an object of class `Ruuid'.

_A_u_t_h_o_r(_s):

     R. Gentleman and Jeff Gentry

_R_e_f_e_r_e_n_c_e_s:

     Theodore Ts'o's Universally Unique ID library
     <URL: http://web.mit.edu/tytso/www/home.html>

_S_e_e _A_l_s_o:

     `Ruuid', `uuidt'

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

     z <- getuuid()
     z
     a <- getuuid(stringRep(z))
     a
     q <- getuuid(uuid(z))
     q
     w <- getuuid()
     w

