Changeset 3243 for pjproject/trunk/pjsip/include/pjsip/sip_parser.h

Timestamp:

Aug 1, 2010 9:48:51 AM (14 years ago)

Author:

bennylp

Message:

Implemented core multipart support and support in the invite session (re #1070)

• incoming multipart message will be handled automatically
• for testing, enable HAVE_MULTIPART_TEST in pjsua_app.c

File:

• pjproject/trunk/pjsip/include/pjsip/sip_parser.h (modified) (2 diffs)

pjproject/trunk/pjsip/include/pjsip/sip_parser.h

@@ -277 +277 @@
  *                      pinpoint the location of the error in the buffer.
  *
- * @return              The instance of the header if parsing was successfull,
+ * @return              The instance of the header if parsing was successful,
  *                      or otherwise a NULL pointer will be returned.
  */
@@ -288 +288 @@
  * When there are multiple headers, the headers MUST be separated by either
  * a newline (as in SIP message) or ampersand mark (as in URI). This separator
- * however is optional for the last header.
- *
- * @param pool          the pool.
- * @param input         the input text to parse, which must be NULL terminated.
- * @param size          the text length.
- * @param hlist         the header list to store the parsed headers. 
+ * is optional for the last header.
+ *
+ * @param pool          The pool.
+ * @param input         The input text to parse, which must be NULL terminated.
+ * @param size          The text length.
+ * @param hlist         The header list to store the parsed headers.
  *                      This list must have been initialized before calling 
  *                      this function.
+ * @param options       Specify 1 here to make parsing stop when error is
+ *                      encountered when parsing the header. Otherwise the
+ *                      error is silently ignored and parsing resumes to the
+ *                      next line.
  * @return              zero if successfull, or -1 if error is encountered. 
  *                      Upon error, the \a hlist argument MAY contain 
  *                      successfully parsed headers.
  */
-PJ_DECL(pj_status_t) pjsip_parse_headers( pj_pool_t *pool,
-                                          char *input, pj_size_t size,
-                                          pj_list *hlist );
+PJ_DECL(pj_status_t) pjsip_parse_headers( pj_pool_t *pool, char *input,
+                                          pj_size_t size, pjsip_hdr *hlist,
+                                          unsigned options);