Dokumentacja pliku plugins/jabber/misc.c

#include <errno.h>
#include <string.h>
#include <unistd.h>
#include "ekg2-config.h"
#include <ekg/debug.h>
#include <ekg/plugins.h>
#include <ekg/protocol.h>
#include <ekg/themes.h>
#include <ekg/recode.h>
#include <ekg/stuff.h>
#include <ekg/xmalloc.h>
#include <ekg/log.h>
#include <ekg/queries.h>
#include "jabber.h"
#include "jabber-ssl.h"

Funkcje
static char *	jabber_gpg_strip_header_footer (char *data)
char *	jabber_openpgp (session_t *s, const char *fromto, enum jabber_opengpg_type_t way, char *message, char *key, char **error)
int	JABBER_COMMIT_DATA (watch_t *w)
char *	jabber_attr (char **atts, const char *att)
char *	jabber_escape (const char *text)
char *	jabber_unescape (const char *text)
char *	tlen_encode (const char *what)
char *	tlen_decode (const char *what)
int	jabber_handle_write (int type, int fd, const char *watch, void *data)
int	jabber_conversation_find (jabber_private_t *j, const char *uid, const char *subject, const char *thread, jabber_conversation_t **result, const int can_add)
jabber_conversation_t *	jabber_conversation_get (jabber_private_t *j, const int n)
char *	jabber_thread_gen (jabber_private_t *j, const char *uid)
static uint32_t	jabber_formatchar (const char c)
static int	jabber_fc_check (const char *curr, const char *beginning, const int mode)
uint32_t *	jabber_msg_format (const char *plaintext, const xmlnode_t *html)

---

Dokumentacja funkcji

char* jabber_attr	(	char **	atts,
		const char *	att
	)

int JABBER_COMMIT_DATA

(

watch_t *

w

)

int jabber_conversation_find	(	jabber_private_t *	j,
		const char *	uid,
		const char *	subject,
		const char *	thread,
		jabber_conversation_t **	result,
		const int	can_add
	)

jabber_conversation_find() searches session's conversation list for matching one.

Parametry:

	j	- private data of session.
	uid	- UID of recipient.
	subject	- message subject (for non-threaded conversations).
	thread	- jabber thread ID, if threaded.
	result	- place to write address of jabber_conversation_t or NULL, if not needed.
	can_add	- if nonzero, we can create new conversation, if none match.

Zwraca:

Reply-ID of conversation.

jabber_conversation_t* jabber_conversation_get	(	jabber_private_t *	j,
		const int	n
	)

jabber_conversation_get() is used to get conversation by its Reply-ID.

Parametry:

	j	- private data of session.
	n	- Reply-ID.

Zwraca:

Pointer to jabber_conversation_t or NULL, when no conversation found.

char* jabber_escape

(

const char *

text

)

jabber_escape()

Convert charset from config_console_charset to "utf-8"
Escape xml chars using xml_escape()

Nota:

If config_use_unicode is set, this function return only xml_escape(text)

Parametry:

text

- text to reencode+escape

Zobacz również:

jabber_unescape() - For function reconverting charset back to config_console_charset

Zwraca:

Dynamic allocated string, which should be xfree()'d

static int jabber_fc_check	(	const char *	curr,
		const char *	beginning,
		const int	mode
	)			[inline, static]

static uint32_t jabber_formatchar

(

const char

c

)

[inline, static]

static char* jabber_gpg_strip_header_footer

(

char *

data

)

[static]

int jabber_handle_write	(	int	type,
		int	fd,
		const char *	watch,
		void *	data
	)

uint32_t* jabber_msg_format	(	const char *	plaintext,
		const xmlnode_t *	html
	)

char* jabber_openpgp	(	session_t *	s,
		const char *	fromto,
		enum jabber_opengpg_type_t	way,
		char *	message,
		char *	key,
		char **	error
	)

char* jabber_thread_gen	(	jabber_private_t *	j,
		const char *	uid
	)

jabber_thread_gen() generates new thread-ID for outgoing messages.

Parametry:

	j	- private data of session.
	uid	- recipient UID.

Zwraca:

New, session-unique thread-ID.

char* jabber_unescape

(

const char *

text

)

jabber_unescape()

Convert charset from "utf-8" to config_console_charset.
xml escaped chars are already changed by expat. so we don't care about them.

Nota:

If config_use_unicode is set, this function only xstrdup(text)

Parametry:

text

- text to reencode.

Zobacz również:

jabber_escape() - for function escaping xml chars + reencoding string to utf-8

Zwraca:

Dynamic allocated string, which should be xfree()'d

char* tlen_decode

(

const char *

what

)

tlen_decode()

Decode string ,,encoded'' with urldecode [in ISO-8859-2] and convert charset to config_console_charset

Nota:

It was ripped from libtlen. (c) Libtlen developers see: http://libtlen.sourceforge.net/

Do zrobienia:

Try to rewrite

Parametry:

what

- string to decode.

Zobacz również:

tlen_encode() - for urlencode.

Zwraca:

Dynamic allocated string, which should be xfree()'d

char* tlen_encode

(

const char *

what

)

tlen_encode()

Convert charset from config_console_charset to ISO-8859-2
,,encode'' string with urlencode

Nota:

It was ripped from libtlen. (c) Libtlen developers see: http://libtlen.sourceforge.net/

Do zrobienia:

Try to rewrite.

Parametry:

what

- string to encode.

Zobacz również:

tlen_decode() - for urldecode.

Zwraca:

Dynamic allocated string, which should be xfree()'d