home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xfetchbytes.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XStoreBytes(3X11)      XLIB FUNCTIONS    XStoreBytes(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XStoreBytes, XStoreBuffer, XFetchBytes, XFetchBuffer, XRo-
  9.        tateBuffers - manipulate cut and paste buffers
  10.  
  11. SSYYNNTTAAXX
  12.        XStoreBytes(_d_i_s_p_l_a_y, _b_y_t_e_s, _n_b_y_t_e_s)
  13.          Display *_d_i_s_p_l_a_y;
  14.          char *_b_y_t_e_s;
  15.          int _n_b_y_t_e_s;
  16.  
  17.        XStoreBuffer(_d_i_s_p_l_a_y, _b_y_t_e_s, _n_b_y_t_e_s, _b_u_f_f_e_r)
  18.          Display *_d_i_s_p_l_a_y;
  19.          char *_b_y_t_e_s;
  20.          int _n_b_y_t_e_s;
  21.          int _b_u_f_f_e_r;
  22.  
  23.        char *XFetchBytes(_d_i_s_p_l_a_y, _n_b_y_t_e_s___r_e_t_u_r_n)
  24.          Display *_d_i_s_p_l_a_y;
  25.          int *_n_b_y_t_e_s___r_e_t_u_r_n;
  26.  
  27.        char *XFetchBuffer(_d_i_s_p_l_a_y, _n_b_y_t_e_s___r_e_t_u_r_n, _b_u_f_f_e_r)
  28.          Display *_d_i_s_p_l_a_y;
  29.          int *_n_b_y_t_e_s___r_e_t_u_r_n;
  30.          int _b_u_f_f_e_r;
  31.  
  32.        XRotateBuffers(_d_i_s_p_l_a_y, _r_o_t_a_t_e)
  33.          Display *_d_i_s_p_l_a_y;
  34.          int _r_o_t_a_t_e;
  35.  
  36. AARRGGUUMMEENNTTSS
  37.        _b_u_f_f_e_r     Specifies the buffer in which you want to store
  38.          the bytes or from which you want the stored data
  39.          returned.
  40.  
  41.        _b_y_t_e_s     Specifies the bytes, which are not necessarily
  42.          ASCII or null-terminated.
  43.  
  44.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  45.  
  46.        _n_b_y_t_e_s     Specifies the number of bytes to be stored.
  47.  
  48.        _n_b_y_t_e_s___r_e_t_u_r_n
  49.          Returns the number of bytes in the buffer.
  50.  
  51.        _r_o_t_a_t_e     Specifies how much to rotate the cut buffers.
  52.  
  53. DDEESSCCRRIIPPTTIIOONN
  54.        The data can have embedded null characters and need not be
  55.        null-terminated.     The cut buffer's contents can be
  56.        retrieved later by any client calling _X_F_e_t_c_h_B_y_t_e_s.
  57.  
  58.        _X_S_t_o_r_e_B_y_t_e_s can generate a _B_a_d_A_l_l_o_c error.
  59.  
  60.        If an invalid buffer is specified, the call has no effect.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XStoreBytes(3X11)      XLIB FUNCTIONS    XStoreBytes(3X11)
  71.  
  72.  
  73.        The data can have embedded null characters and need not be
  74.        null-terminated.
  75.  
  76.        _X_S_t_o_r_e_B_u_f_f_e_r can generate a _B_a_d_A_l_l_o_c error.
  77.  
  78.        The _X_F_e_t_c_h_B_y_t_e_s function returns the number of bytes in
  79.        the nbytes_return argument, if the buffer contains data.
  80.        Otherwise, the function returns NULL and sets nbytes to 0.
  81.        The appropriate amount of storage is allocated and the
  82.        pointer returned.  The client must free this storage when
  83.        finished with it by calling _X_F_r_e_e.
  84.  
  85.        The _X_F_e_t_c_h_B_u_f_f_e_r function returns zero to the
  86.        nbytes_return argument if there is no data in the buffer
  87.        or if an invalid buffer is specified.
  88.  
  89.        _X_F_e_t_c_h_B_u_f_f_e_r can generate a _B_a_d_V_a_l_u_e error.
  90.  
  91.        The _X_R_o_t_a_t_e_B_u_f_f_e_r_s function rotates the cut buffers, such
  92.        that buffer 0 becomes buffer n, buffer 1 becomes n + 1 mod
  93.        8, and so on.  This cut buffer numbering is global to the
  94.        display.     Note that _X_R_o_t_a_t_e_B_u_f_f_e_r_s generates _B_a_d_M_a_t_c_h
  95.        errors if any of the eight buffers have not been created.
  96.  
  97.        _X_R_o_t_a_t_e_B_u_f_f_e_r_s can generate a _B_a_d_M_a_t_c_h error.
  98.  
  99. DDIIAAGGNNOOSSTTIICCSS
  100.        _B_a_d_A_l_l_o_c     The server failed to allocate the requested
  101.          resource or server memory.
  102.  
  103.        _B_a_d_A_t_o_m     A value for an Atom argument does not name a
  104.          defined Atom.
  105.  
  106.        _B_a_d_M_a_t_c_h     Some argument or pair of arguments has the cor-
  107.          rect type and range but fails to match in some
  108.          other way required by the request.
  109.  
  110.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  111.          values accepted by the request.  Unless a spe-
  112.          cific range is specified for an argument, the
  113.          full range defined by the argument's type is
  114.          accepted.  Any argument defined as a set of
  115.          alternatives can generate this error.
  116.  
  117. SSEEEE AALLSSOO
  118.        XFree(3X11)
  119.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.