Blame doc/html/printbuf_8h.html

Packit Service def718
Packit Service def718
<html xmlns="http://www.w3.org/1999/xhtml">
Packit Service def718
<head>
Packit Service def718
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
Packit Service def718
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
Packit Service def718
<meta name="generator" content="Doxygen 1.8.8"/>
Packit Service def718
<title>json-c: printbuf.h File Reference</title>
Packit Service def718
<link href="tabs.css" rel="stylesheet" type="text/css"/>
Packit Service def718
<script type="text/javascript" src="jquery.js"></script>
Packit Service def718
<script type="text/javascript" src="dynsections.js"></script>
Packit Service def718
<link href="doxygen.css" rel="stylesheet" type="text/css" />
Packit Service def718
</head>
Packit Service def718
<body>
Packit Service def718
Packit Service def718
Packit Service def718
Packit Service def718
 
Packit Service def718
 
Packit Service def718
  
Packit Service def718
   
json-c
Packit Service def718
    0.13.1
Packit Service def718
   
Packit Service def718
  
Packit Service def718
 
Packit Service def718
 
Packit Service def718
Packit Service def718
Packit Service def718
Packit Service def718
Packit Service def718
  
Packit Service def718
    
    Packit Service def718
          
  • Main Page
  • Packit Service def718
          
  • Related Pages
  • Packit Service def718
          
  • Data Structures
  • Packit Service def718
          
  • Files
  • Packit Service def718
        
    Packit Service def718
      
    Packit Service def718
      
    Packit Service def718
        
      Packit Service def718
            
    • File List
    • Packit Service def718
            
    • Globals
    • Packit Service def718
          
      Packit Service def718
        
      Packit Service def718
      Packit Service def718
      Packit Service def718
        
      Packit Service def718
      Data Structures |
      Packit Service def718
      Macros |
      Packit Service def718
      Typedefs |
      Packit Service def718
      Functions  
      Packit Service def718
        
      Packit Service def718
      printbuf.h File Reference
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718

      Internal string buffer handing. Unless you're writing a json_object_to_json_string_fn implementation for use with json_object_set_serializer() direct use of this is not recommended.

      Packit Service def718
      More...

      Packit Service def718
      Packit Service def718

      Packit Service def718
      Data Structures
      Packit Service def718
      struct  printbuf
      Packit Service def718
       
      Packit Service def718
      Packit Service def718

      Packit Service def718
      Macros
      Packit Service def718
      #define printbuf_memappend_fast(p, bufptr, bufsize)
      Packit Service def718
       
      Packit Service def718
      #define printbuf_length(p)   ((p)->bpos)
      Packit Service def718
       
      Packit Service def718
      #define _printbuf_check_literal(mystr)   ("" mystr)
      Packit Service def718
       
      Packit Service def718
      #define printbuf_strappend(pb, str)   printbuf_memappend ((pb), _printbuf_check_literal(str), sizeof(str) - 1)
      Packit Service def718
       
      Packit Service def718
      Packit Service def718

      Packit Service def718
      Typedefs
      Packit Service def718
      typedef struct printbuf printbuf
      Packit Service def718
       
      Packit Service def718
      Packit Service def718

      Packit Service def718
      Functions
      Packit Service def718
      struct printbufprintbuf_new (void)
      Packit Service def718
       
      Packit Service def718
      int printbuf_memappend (struct printbuf *p, const char *buf, int size)
      Packit Service def718
       
      Packit Service def718
      int printbuf_memset (struct printbuf *pb, int offset, int charvalue, int len)
      Packit Service def718
       
      Packit Service def718
      int sprintbuf (struct printbuf *p, const char *msg,...)
      Packit Service def718
       
      Packit Service def718
      void printbuf_reset (struct printbuf *p)
      Packit Service def718
       
      Packit Service def718
      void printbuf_free (struct printbuf *p)
      Packit Service def718
       
      Packit Service def718
      Packit Service def718

      Detailed Description

      Packit Service def718

      Internal string buffer handing. Unless you're writing a json_object_to_json_string_fn implementation for use with json_object_set_serializer() direct use of this is not recommended.

      Packit Service def718

      Macro Definition Documentation

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                #define _printbuf_check_literal
      Packit Service def718
                (
      Packit Service def718
                 
      Packit Service def718
                mystr)
      Packit Service def718
                   ("" mystr)
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718

      Results in a compile error if the argument is not a string literal.

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                #define printbuf_length
      Packit Service def718
                (
      Packit Service def718
                 
      Packit Service def718
                p)
      Packit Service def718
                   ((p)->bpos)
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                #define printbuf_memappend_fast
      Packit Service def718
                (
      Packit Service def718
                 
      Packit Service def718
                p, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                 
      Packit Service def718
                bufptr, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                 
      Packit Service def718
                bufsize 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                )
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Value:
      do { \
      Packit Service def718
      if ((p->size - p->bpos) > bufsize) { \
      Packit Service def718
      memcpy(p->buf + p->bpos, (bufptr), bufsize); \
      Packit Service def718
      p->bpos += bufsize; \
      Packit Service def718
      p->buf[p->bpos]= '\0'; \
      Packit Service def718
      } else { printbuf_memappend(p, (bufptr), bufsize); } \
      Packit Service def718
      } while (0)
      Packit Service def718
      int printbuf_memappend(struct printbuf *p, const char *buf, int size)
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                #define printbuf_strappend
      Packit Service def718
                (
      Packit Service def718
                 
      Packit Service def718
                pb, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                 
      Packit Service def718
                str 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                )
      Packit Service def718
                   printbuf_memappend ((pb), _printbuf_check_literal(str), sizeof(str) - 1)
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718

      This is an optimization wrapper around printbuf_memappend() that is useful for appending string literals. Since the size of string constants is known at compile time, using this macro can avoid a costly strlen() call. This is especially helpful when a constant string must be appended many times. If you got here because of a compilation error caused by passing something other than a string literal, use printbuf_memappend_fast() in conjunction with strlen().

      Packit Service def718

      See also: printbuf_memappend_fast() printbuf_memappend() sprintbuf()

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718

      Typedef Documentation

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                typedef struct printbuf printbuf
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718

      Function Documentation

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                void printbuf_free 
      Packit Service def718
                (
      Packit Service def718
                struct printbuf
      Packit Service def718
                p)
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                int printbuf_memappend 
      Packit Service def718
                (
      Packit Service def718
                struct printbuf
      Packit Service def718
                p, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                const char * 
      Packit Service def718
                buf, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                int 
      Packit Service def718
                size 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                )
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                int printbuf_memset 
      Packit Service def718
                (
      Packit Service def718
                struct printbuf
      Packit Service def718
                pb, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                int 
      Packit Service def718
                offset, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                int 
      Packit Service def718
                charvalue, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                int 
      Packit Service def718
                len 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                )
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718

      Set len bytes of the buffer to charvalue, starting at offset offset. Similar to calling memset(x, charvalue, len);

      Packit Service def718

      The memory allocated for the buffer is extended as necessary.

      Packit Service def718

      If offset is -1, this starts at the end of the current data in the buffer.

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                struct printbuf* printbuf_new 
      Packit Service def718
                (
      Packit Service def718
                void 
      Packit Service def718
                )
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                void printbuf_reset 
      Packit Service def718
                (
      Packit Service def718
                struct printbuf
      Packit Service def718
                p)
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
            
      Packit Service def718
              
      Packit Service def718
                int sprintbuf 
      Packit Service def718
                (
      Packit Service def718
                struct printbuf
      Packit Service def718
                p, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                const char * 
      Packit Service def718
                msg, 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                
      Packit Service def718
                 
      Packit Service def718
                ... 
      Packit Service def718
              
      Packit Service def718
              
      Packit Service def718
                
      Packit Service def718
                )
      Packit Service def718
                
      Packit Service def718
              
      Packit Service def718
            
      Packit Service def718
      Packit Service def718

      Formatted print to printbuf.

      Packit Service def718

      This function is the most expensive of the available functions for appending string data to a printbuf and should be used only where convenience is more important than speed. Avoid using this function in high performance code or tight loops; in these scenarios, consider using snprintf() with a static buffer in conjunction with one of the printbuf_*append() functions.

      Packit Service def718

      See also: printbuf_memappend_fast() printbuf_memappend() printbuf_strappend()

      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718
      Packit Service def718

      <address class="footer"><small>
      Packit Service def718
      Generated on Mon Mar 5 2018 23:17:09 for json-c by  
      Packit Service def718
      doxygen
      Packit Service def718
       1.8.8
      Packit Service def718
      </small></address>
      Packit Service def718
      </body>
      Packit Service def718
      </html>