pidgin/pidgin

Add some new methods to purple tags
default tip
12 hours ago, Gary Kramlich
b45add2a840c
Add some new methods to purple tags

* purple_tags_exists is a simplier version of purple_tags_lookup.
* purple_tags_contains makes it easier to find multiple matching tags.

Testing Done:
Ran the unit tests under valgrind and had the turtles check in on things too.

Reviewed at https://reviews.imfreedom.org/r/3143/
/*
* Purple - Internet Messaging Library
* Copyright (C) Pidgin Developers <devel@pidgin.im>
*
* 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 library 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 library 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 library; if not, see <https://www.gnu.org/licenses/>.
*/
#if !defined(PURPLE_GLOBAL_HEADER_INSIDE) && !defined(PURPLE_COMPILATION)
# error "only <purple.h> may be included directly"
#endif
#ifndef PURPLE_MEDIA_CODEC_H
#define PURPLE_MEDIA_CODEC_H
#include "enum-types.h"
/**
* PurpleMediaCodec:
*
* An opaque structure representing an audio or video codec.
*/
typedef struct _PurpleMediaCodec PurpleMediaCodec;
#include "purplekeyvaluepair.h"
#include "purpleversion.h"
#include <glib-object.h>
G_BEGIN_DECLS
/**
* PURPLE_MEDIA_TYPE_CODEC:
*
* The standard _get_type macro for #PurpleMediaCodec.
*
* Since: 3.0
*/
#define PURPLE_MEDIA_TYPE_CODEC purple_media_codec_get_type()
/**
* purple_media_codec_get_type:
*
* Gets the type of the media codec structure.
*
* Returns: The media codec's GType
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
G_DECLARE_FINAL_TYPE(PurpleMediaCodec, purple_media_codec, PURPLE_MEDIA,
CODEC, GObject)
/**
* purple_media_codec_new:
* @id: Codec identifier.
* @encoding_name: Name of the media type this encodes.
* @media_type: PurpleMediaSessionType of this codec.
* @clock_rate: The clock rate this codec encodes at, if applicable.
*
* Creates a new PurpleMediaCodec instance.
*
* Returns: The newly created PurpleMediaCodec.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
PurpleMediaCodec *purple_media_codec_new(int id, const char *encoding_name,
PurpleMediaSessionType media_type, guint clock_rate);
/**
* purple_media_codec_get_id:
* @codec: The codec to get the id from.
*
* Gets the codec id.
*
* Returns: The codec id.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
guint purple_media_codec_get_id(PurpleMediaCodec *codec);
/**
* purple_media_codec_get_encoding_name:
* @codec: The codec to get the encoding name from.
*
* Gets the encoding name.
*
* Returns: The encoding name.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gchar *purple_media_codec_get_encoding_name(PurpleMediaCodec *codec);
/**
* purple_media_codec_get_clock_rate:
* @codec: The codec to get the clock rate from.
*
* Gets the clock rate.
*
* Returns: The clock rate.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
guint purple_media_codec_get_clock_rate(PurpleMediaCodec *codec);
/**
* purple_media_codec_get_channels:
* @codec: The codec to get the number of channels from.
*
* Gets the number of channels.
*
* Returns: The number of channels.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
guint purple_media_codec_get_channels(PurpleMediaCodec *codec);
/**
* purple_media_codec_get_optional_parameters:
* @codec: The codec to get the optional parameters from.
*
* Gets a list of the optional parameters.
*
* Returns: (element-type PurpleKeyValuePair) (transfer none): The list of
* optional parameters.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
GList *purple_media_codec_get_optional_parameters(PurpleMediaCodec *codec);
/**
* purple_media_codec_add_optional_parameter:
* @codec: The codec to add the parameter to.
* @name: The name of the parameter to add.
* @value: The value of the parameter to add.
*
* Adds an optional parameter to the codec.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_codec_add_optional_parameter(PurpleMediaCodec *codec,
const gchar *name, const gchar *value);
/**
* purple_media_codec_remove_optional_parameter:
* @codec: The codec to remove the parameter from.
* @param: A pointer to the parameter to remove.
*
* Removes an optional parameter from the codec.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_codec_remove_optional_parameter(PurpleMediaCodec *codec,
PurpleKeyValuePair *param);
/**
* purple_media_codec_get_optional_parameter:
* @codec: The codec to find the parameter in.
* @name: The name of the parameter to search for.
* @value: The value to search for or NULL.
*
* Gets an optional parameter based on the values given.
*
* Returns: (transfer none): The value found or NULL.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
PurpleKeyValuePair *purple_media_codec_get_optional_parameter(
PurpleMediaCodec *codec, const gchar *name,
const gchar *value);
/**
* purple_media_codec_copy:
* @codec: The codec to copy.
*
* Copies a PurpleMediaCodec object.
*
* Returns: (transfer full): The copy of the codec.
*
* Since: 2.7
*/
PURPLE_AVAILABLE_IN_2_7
PurpleMediaCodec *purple_media_codec_copy(PurpleMediaCodec *codec);
/**
* purple_media_codec_list_copy:
* @codecs: (element-type PurpleMediaCodec) (transfer none): The list of codecs
* to be copied.
*
* Copies a GList of PurpleMediaCodec and its contents.
*
* Returns: (element-type PurpleMediaCodec) (transfer full): The copy of the
* codec list.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
GList *purple_media_codec_list_copy(GList *codecs);
/**
* purple_media_codec_list_free:
* @codecs: (element-type PurpleMediaCodec) (transfer full): The list of codecs
* to be freed.
*
* Frees a GList of PurpleMediaCodec and its contents.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
void purple_media_codec_list_free(GList *codecs);
/**
* purple_media_codec_to_string:
* @codec: The codec to create the string of.
*
* Creates a string representation of the codec.
*
* Returns: The new string representation.
*
* Since: 2.6
*/
PURPLE_AVAILABLE_IN_2_6
gchar *purple_media_codec_to_string(PurpleMediaCodec *codec);
G_END_DECLS
#endif /* PURPLE_MEDIA_CODEC_H */