【Libevent】 TCP 服务器编写知识点

痛定思痛。 2022-12-31 08:24 147阅读 0赞

/**
      Read data from a bufferevent buffer.
    
      The bufferevent_read() function is used to read data from the input buffer.
    
      @param bufev the bufferevent to be read from
      @param data pointer to a buffer that will store the data
      @param size the size of the data buffer, in bytes
      @return the amount of data read, in bytes.
     */
    EVENT2_EXPORT_SYMBOL
    size_t bufferevent_read(struct bufferevent *bufev, void *data, size_t size);

/**
       A callback that we invoke when a listener has a new connection.
    
       @param listener The evconnlistener
       @param fd The new file descriptor
       @param addr The source address of the connection
       @param socklen The length of addr
       @param user_arg the pointer passed to evconnlistener_new()
     */
    typedef void (*evconnlistener_cb)(struct evconnlistener *, evutil_socket_t, struct sockaddr *, int socklen, void *);

>  /\*\*  
>   Changes the callbacks for a bufferevent.
> 
>   @param bufev the bufferevent object for which to change callbacks  
>   @param readcb callback to invoke when there is data to be read, or NULL if  
>      no callback is desired  
>   @param writecb callback to invoke when the file descriptor is ready for  
>      writing, or NULL if no callback is desired  
>   @param **eventcb** callback to invoke when there is an event on the file  
>      descriptor  
>   @param cbarg an argument that will be supplied to each of the callbacks  
>      (readcb, writecb, and errorcb)  
>   @see bufferevent\_new()  
>   \*/  
> EVENT2\_EXPORT\_SYMBOL  
> void bufferevent\_setcb(struct bufferevent \*bufev,  
>     bufferevent\_data\_cb readcb, bufferevent\_data\_cb writecb,  
>     bufferevent\_event\_cb eventcb, void \*cbarg);

> bufferevent\_setcb()函数修改 bufferevent 的一个或者多个回调. readcb、writecb 和 eventcb 函数将分别在已经读 
> 
> 取足够的数据、已经写入足够的数据 ,  **或者发生错误时被调用** . 每个回调 函 数 的 第 一 个 参 数 都 是 发 生 了 
> 
> 事 件 的  bufferevent ,  最 后 一 个 参 数 都 是 调 用  bufferevent\_setcb() 时用户提供的  cbarg  参数 : 可以通过它向回调 
> 
> 传递数据 . 事件回调的  events  参数是一个表示事件标志的位掩码 : 请看前面的 " 回调和水位 " 节 .