/usr/include/licq/userid.h is in licq-dev 1.6.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 | /*
* This file is part of Licq, an instant messaging client for UNIX.
* Copyright (C) 2010-2011 Licq developers
*
* Licq 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.
*
* Licq 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 Licq; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef LICQ_USERID_H
#define LICQ_USERID_H
#include <string>
// Known Protocol IDs
// Should be local per protocol but defined here as they can also be useful for plugins
#define LICQ_PPID 0x4C696371 // "Licq" (ICQ & AIM)
#define MSN_PPID 0x4D534E5F // "MSN_" (MSN)
#define JABBER_PPID 0x584D5050 // "XMPP" (Jabber)
namespace Licq
{
// Convenience function to convert protocolId to a string
// ret must be able to hold at least 5 characters
inline std::string protocolId_toString(unsigned long protocolId)
{
char ret[5];
ret[0] = ((protocolId & 0xFF000000) >> 24);
ret[1] = ((protocolId & 0x00FF0000) >> 16);
ret[2] = ((protocolId & 0x0000FF00) >> 8);
ret[3] = ((protocolId & 0x000000FF));
ret[4] = '\0';
return ret;
}
/**
* Identity of a user
*/
class UserId
{
public:
/**
* Default constructor
* Creates an invalid user id
*/
UserId()
: myProtocolId(0)
{ /* Empty */ }
/**
* Constructor
* Creates a user id from account id and protocol id
*/
UserId(const std::string& accountId, unsigned long protocolId)
: myProtocolId(protocolId), myAccountId(normalizeId(accountId, protocolId))
{ /* Empty */ }
/**
* Copy constructor
*/
UserId(const UserId& userId)
: myProtocolId(userId.myProtocolId), myAccountId(userId.myAccountId)
{ /* Empty */ }
/**
* Assignment operator
*/
UserId& operator=(const UserId& userId)
{ myProtocolId = userId.myProtocolId; myAccountId = userId.myAccountId; return *this; }
/**
* Test if two user ids are the same
*/
bool operator==(const UserId& userId) const
{ return (myProtocolId == userId.myProtocolId && myAccountId == userId.myAccountId); }
/**
* Test if two user ids are not equal
*/
bool operator!=(const UserId& userId) const
{ return !(*this == userId); }
/**
* Determine sort order of user ids
*/
bool operator<(const UserId& userId) const
{ return (myProtocolId < userId.myProtocolId || (myProtocolId == userId.myProtocolId && myAccountId < userId.myAccountId)); }
/**
* Get protocol id part of user id
*
* @return protocol id if user id is valid, otherwise zero
*/
unsigned long protocolId() const
{ return myProtocolId; }
/**
* Get account id part of user id
*
* @return account id if user id is valid, otherwise an empty string
*/
const std::string& accountId() const
{ return myAccountId; }
/**
* Check if user id is valid
*
* @return True if user id is valid
*/
bool isValid() const
{ return (myProtocolId != 0); }
/**
* Convert user id to string (for use in debug printouts etc.)
*
* @return A printable string of user id
*/
std::string toString() const
{ return protocolId_toString(myProtocolId) + myAccountId; }
/**
* Normalize an account id
* TODO: This should be done in protocol plugins, not here
*
* @param accountId Account id
* @param ppid Protocol instance id
* @return Normalized account id
*/
static std::string normalizeId(const std::string& accountId, unsigned long protocolId);
private:
unsigned long myProtocolId;
std::string myAccountId;
};
} // namespace Licq
#endif
|