Frameworks/libpurple.framework/Versions/2.10.12r8d2874a79747/Headers/mime.h
branchadium-1.5.11
changeset 6014 fcb71cb71a3d
parent 5941 307f53385811
parent 6013 f8d0dc659e3f
child 6016 325e2ab3406f
--- a/Frameworks/libpurple.framework/Versions/2.10.12r8d2874a79747/Headers/mime.h	Sun Sep 04 21:31:36 2016 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,218 +0,0 @@
-/*
- * Purple
- *
- * Purple is the legal property of its developers, whose names are too
- * numerous to list here. Please refer to the COPYRIGHT file distributed
- * with this source distribution
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or (at
- * your option) any later version.
- *
- * This program is distributed in the hope that it will be useful, but
- * WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301,
- * USA.
- */
-
-#ifndef _PURPLE_MIME_H
-#define _PURPLE_MIME_H
-
-#include <glib.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @file mime.h
- * @ingroup core
- *
- * Rudimentary parsing of multi-part MIME messages into more
- * accessible structures.
- */
-
-/**
- * A MIME document.
- */
-typedef struct _PurpleMimeDocument PurpleMimeDocument;
-
-/**
- * A part of a multipart MIME document.
- */
-typedef struct _PurpleMimePart PurpleMimePart;
-
-/**
- * Allocate an empty MIME document.
- */
-PurpleMimeDocument *purple_mime_document_new(void);
-
-/**
- * Frees memory used in a MIME document and all of its parts and fields
- *
- * @param doc The MIME document to free.
- */
-void purple_mime_document_free(PurpleMimeDocument *doc);
-
-/**
- * Parse a MIME document from a NUL-terminated string.
- *
- * @param buf The NULL-terminated string containing the MIME-encoded data.
- *
- * @returns A MIME document.
- */
-PurpleMimeDocument *purple_mime_document_parse(const char *buf);
-
-/**
- * Parse a MIME document from a string
- *
- * @param buf The string containing the MIME-encoded data.
- * @param len Length of buf.
- *
- * @returns   A MIME document.
- */
-PurpleMimeDocument *purple_mime_document_parsen(const char *buf, gsize len);
-
-/**
- * Write (append) a MIME document onto a GString.
- */
-void purple_mime_document_write(PurpleMimeDocument *doc, GString *str);
-
-/**
- * The list of fields in the header of a document
- *
- * @param doc The MIME document.
- *
- * @constreturn A list of strings indicating the fields (but not the values
- *              of the fields) in the header of doc.
- */
-GList *purple_mime_document_get_fields(PurpleMimeDocument *doc);
-
-/**
- * Get the value of a specific field in the header of a document.
- *
- * @param doc   The MIME document.
- * @param field Case-insensitive field name.
- *
- * @returns     Value associated with the indicated header field, or
- *              NULL if the field doesn't exist.
- */
-const char *purple_mime_document_get_field(PurpleMimeDocument *doc,
-					 const char *field);
-
-/**
- * Set or replace the value of a specific field in the header of a
- * document.
- *
- * @param doc   The MIME document.
- * @param field Case-insensitive field name.
- * @param value Value to associate with the indicated header field,
- *              of NULL to remove the field.
- */
-void purple_mime_document_set_field(PurpleMimeDocument *doc,
-				  const char *field,
-				  const char *value);
-
-/**
- * The list of parts in a multipart document.
- *
- * @param doc The MIME document.
- *
- * @constreturn   List of PurpleMimePart contained within doc.
- */
-GList *purple_mime_document_get_parts(PurpleMimeDocument *doc);
-
-/**
- * Create and insert a new part into a MIME document.
- *
- * @param doc The new part's parent MIME document.
- */
-PurpleMimePart *purple_mime_part_new(PurpleMimeDocument *doc);
-
-
-/**
- * The list of fields in the header of a document part.
- *
- * @param part The MIME document part.
- *
- * @constreturn List of strings indicating the fields (but not the values
- *              of the fields) in the header of part.
- */
-GList *purple_mime_part_get_fields(PurpleMimePart *part);
-
-
-/**
- * Get the value of a specific field in the header of a document part.
- *
- * @param part  The MIME document part.
- * @param field Case-insensitive name of the header field.
- *
- * @returns     Value of the specified header field, or NULL if the
- *              field doesn't exist.
- */
-const char *purple_mime_part_get_field(PurpleMimePart *part,
-				     const char *field);
-
-/**
- * Get the decoded value of a specific field in the header of a
- * document part.
- */
-char *purple_mime_part_get_field_decoded(PurpleMimePart *part,
-				       const char *field);
-
-/**
- * Set or replace the value of a specific field in the header of a
- * document.
- *
- * @param part  The part of the MIME document.
- * @param field Case-insensitive field name
- * @param value Value to associate with the indicated header field,
- *              of NULL to remove the field.
- */
-void purple_mime_part_set_field(PurpleMimePart *part,
-			      const char *field,
-			      const char *value);
-
-/**
- * Get the (possibly encoded) data portion of a MIME document part.
- *
- * @param part The MIME document part.
- *
- * @returns    NULL-terminated data found in the document part
- */
-const char *purple_mime_part_get_data(PurpleMimePart *part);
-
-/**
- * Get the data portion of a MIME document part, after attempting to
- * decode it according to the content-transfer-encoding field. If the
- * specified encoding method is not supported, this function will
- * return NULL.
- *
- * @param part The MIME documemt part.
- * @param data Buffer for the data.
- * @param len  The length of the buffer.
- */
-void purple_mime_part_get_data_decoded(PurpleMimePart *part,
-				     guchar **data, gsize *len);
-
-/**
- * Get the length of the data portion of a MIME document part.
- *
- * @param part The MIME document part.
- * @returns    Length of the data in the document part.
- */
-gsize purple_mime_part_get_length(PurpleMimePart *part);
-
-void purple_mime_part_set_data(PurpleMimePart *part, const char *data);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif