~ubuntu-branches/ubuntu/wily/telepathy-glib/wily

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-get-valid-accounts" title="tp_account_manager_get_valid_accounts ()">tp_account_manager_get_valid_accounts</a>

(<code><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager</code>);

<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-get-most-available-presence" title="tp_account_manager_get_most_available_presence ()">tp_account_manager_get_most_available_presence</a>

(<code><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **status</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **message</code>);

182

183

184

<a name="account-manager"></a>Example 2. TpAccountManager example

185

186

187

<tbody>

188

<tr>

189

<td class="listing_lines" align="right"><pre>1

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

100

289

101</pre></td>

290

<td class="listing_code"><pre class="programlisting">/*

291

* contact-list

292

*

293

294

*

295

* Copying and distribution of this file, with or without modification,

296

* are permitted in any medium without royalty provided the copyright

297

* notice and this notice are preserved.

298

*/

299

300

#include <telepathy-glib/telepathy-glib.h>

301

#include <telepathy-glib/debug.h>

302

303

static void

304

account_manager_prepared_cb (GObject *object,

305

GAsyncResult *res,

306

gpointer user_data)

307

{

308

TpAccountManager *manager = (<a href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *) object;

309

GMainLoop *loop = user_data;

310

GList *accounts;

311

GError *error = <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>;

312

313

if (!<a href="telepathy-glib-proxy.html#tp-proxy-prepare-finish">tp_proxy_prepare_finish</a> (object, res, &error))

314

{

315

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a> ("Error preparing AM: %s\n", error->message);

316

goto OUT;

317

}

318

319

for (accounts = <a href="telepathy-glib-account-manager.html#tp-account-manager-get-valid-accounts">tp_account_manager_get_valid_accounts</a> (manager);

320

accounts != <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>; accounts = <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-delete-link">g_list_delete_link</a> (accounts, accounts))

321

{

322

TpAccount *account = accounts->data;

323

TpConnection *connection = <a href="telepathy-glib-account.html#tp-account-get-connection">tp_account_get_connection</a> (account);

324

GPtrArray *contacts;

325

guint i;

326

327

/* Verify account is online and received its contact list. If state is not

328

* SUCCESS this means we didn't received the roster from server yet and

329

* we would have to wait for the "notify:contact-list-state" signal. */

330

if (connection == <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a> ||

331

<a href="telepathy-glib-connection.html#tp-connection-get-contact-list-state">tp_connection_get_contact_list_state</a> (connection) !=

332

<a href="telepathy-glib-enums.html#TP-CONTACT-LIST-STATE-SUCCESS:CAPS">TP_CONTACT_LIST_STATE_SUCCESS</a>)

333

continue;

334

335

contacts = <a href="telepathy-glib-connection.html#tp-connection-dup-contact-list">tp_connection_dup_contact_list</a> (connection);

336

for (i = 0; i < contacts->len; i++)

337

{

338

TpContact *contact = <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a> (contacts, i);

339

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * const *groups;

340

341

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a> ("contact %s (%s) in groups:\n",

342

<a href="telepathy-glib-contact.html#tp-contact-get-identifier">tp_contact_get_identifier</a> (contact),

343

<a href="telepathy-glib-contact.html#tp-contact-get-alias">tp_contact_get_alias</a> (contact));

344

345

for (groups = <a href="telepathy-glib-contact.html#tp-contact-get-contact-groups">tp_contact_get_contact_groups</a> (contact);

346

*groups != <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>; groups++)

347

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a> (" %s\n", *groups);

348

}

349

<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#g-ptr-array-unref">g_ptr_array_unref</a> (contacts);

350

}

351

352

OUT:

353

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit">g_main_loop_quit</a> (loop);

354

}

355

356

int

357

main (int argc,

358

char **argv)

359

{

360

TpAccountManager *manager;

361

TpSimpleClientFactory *factory;

362

GMainLoop *loop;

363

364

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#g-type-init">g_type_init</a> ();

365

<a href="telepathy-glib-debug.html#tp-debug-set-flags">tp_debug_set_flags</a> (<a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-getenv">g_getenv</a> ("EXAMPLE_DEBUG"));

366

367

loop = <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-new">g_main_loop_new</a> (<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a>);

368

369

manager = <a href="telepathy-glib-account-manager.html#tp-account-manager-dup">tp_account_manager_dup</a> ();

370

factory = <a href="telepathy-glib-proxy.html#tp-proxy-get-factory">tp_proxy_get_factory</a> (manager);

371

<a href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-add-account-features-varargs">tp_simple_client_factory_add_account_features_varargs</a> (factory,

372

<a href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CONNECTION:CAPS">TP_ACCOUNT_FEATURE_CONNECTION</a>,

373

0);

374

<a href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-add-connection-features-varargs">tp_simple_client_factory_add_connection_features_varargs</a> (factory,

375

<a href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CONTACT-LIST:CAPS">TP_CONNECTION_FEATURE_CONTACT_LIST</a>,

376

0);

377

<a href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-add-contact-features-varargs">tp_simple_client_factory_add_contact_features_varargs</a> (factory,

378

<a href="telepathy-glib-contact.html#TP-CONTACT-FEATURE-ALIAS:CAPS">TP_CONTACT_FEATURE_ALIAS</a>,

379

<a href="telepathy-glib-contact.html#TP-CONTACT-FEATURE-CONTACT-GROUPS:CAPS">TP_CONTACT_FEATURE_CONTACT_GROUPS</a>,

380

<a href="telepathy-glib-contact.html#TP-CONTACT-FEATURE-INVALID:CAPS">TP_CONTACT_FEATURE_INVALID</a>);

381

382

<a href="telepathy-glib-proxy.html#tp-proxy-prepare-async">tp_proxy_prepare_async</a> (manager, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, account_manager_prepared_cb, loop);

383

384

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-run">g_main_loop_run</a> (loop);

385

386

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (manager);

387

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-unref">g_main_loop_unref</a> (loop);

388

389

return 0;

390

}</pre></td>

391

</tr>

392

</tbody>

393

</table>

394

</div>

395

185

<div class="example-contents"><pre class="programlisting">/*

186

* contact-list

187

188

189

190

* Copying and distribution of this file, with or without modification,

191

* are permitted in any medium without royalty provided the copyright

192

* notice and this notice are preserved.

193

194

195

#include <telepathy-glib/telepathy-glib.h>

196

#include <telepathy-glib/debug.h>

197

198

static void

199

account_manager_prepared_cb (GObject *object,

200

GAsyncResult *res,

201

gpointer user_data)

202

{

203

TpAccountManager *manager = (TpAccountManager *) object;

204

GMainLoop *loop = user_data;

205

GList *accounts;

206

GError *error = NULL;

207

208

if (!tp_proxy_prepare_finish (object, res, &error))

209

{

210

g_print ("Error preparing AM: %s\n", error->message);

211

goto OUT;

212

}

213

214

for (accounts = tp_account_manager_get_valid_accounts (manager);

215

accounts != NULL; accounts = g_list_delete_link (accounts, accounts))

216

{

217

TpAccount *account = accounts->data;

218

TpConnection *connection = tp_account_get_connection (account);

219

GPtrArray *contacts;

220

guint i;

221

222

/* Verify account is online and received its contact list. If state is not

223

* SUCCESS this means we didn't received the roster from server yet and

224

* we would have to wait for the "notify:contact-list-state" signal. */

225

if (connection == NULL ||

226

tp_connection_get_contact_list_state (connection) !=

227

TP_CONTACT_LIST_STATE_SUCCESS)

228

continue;

229

230

contacts = tp_connection_dup_contact_list (connection);

231

for (i = 0; i < contacts->len; i++)

232

{

233

TpContact *contact = g_ptr_array_index (contacts, i);

234

const gchar * const *groups;

235

236

g_print ("contact %s (%s) in groups:\n",

237

tp_contact_get_identifier (contact),

238

tp_contact_get_alias (contact));

239

240

for (groups = tp_contact_get_contact_groups (contact);

241

*groups != NULL; groups++)

242

g_print (" %s\n", *groups);

243

}

244

g_ptr_array_unref (contacts);

245

}

246

247

OUT:

248

g_main_loop_quit (loop);

249

}

250

251

int

252

main (int argc,

253

char **argv)

254

{

255

TpAccountManager *manager;

256

TpSimpleClientFactory *factory;

257

GMainLoop *loop;

258

259

g_type_init ();

260

tp_debug_set_flags (g_getenv ("EXAMPLE_DEBUG"));

261

262

loop = g_main_loop_new (NULL, FALSE);

263

264

manager = tp_account_manager_dup ();

265

factory = tp_proxy_get_factory (manager);

266

tp_simple_client_factory_add_account_features_varargs (factory,

267

TP_ACCOUNT_FEATURE_CONNECTION,

268

0);

269

tp_simple_client_factory_add_connection_features_varargs (factory,

270

TP_CONNECTION_FEATURE_CONTACT_LIST,

271

0);

272

tp_simple_client_factory_add_contact_features_varargs (factory,

273

TP_CONTACT_FEATURE_ALIAS,

274

TP_CONTACT_FEATURE_CONTACT_GROUPS,

275

TP_CONTACT_FEATURE_INVALID);

276

277

tp_proxy_prepare_async (manager, NULL, account_manager_prepared_cb, loop);

278

279

g_main_loop_run (loop);

280

281

g_object_unref (manager);

282

g_main_loop_unref (loop);

283

284

return 0;

285

}

286

</pre></div>

396

287

</div>

397

288

398

289

705

596

before returning from this function. One could ref every item in the list

706

597

like the following example:

707

598

708

709

710

<tbody>

711

<tr>

712

<td class="listing_lines" align="right"><pre>1

713

714

3</pre></td>

715

<td class="listing_code"><pre class="programlisting">GList *accounts;

716

account = <a href="telepathy-glib-account-manager.html#tp-account-manager-get-valid-accounts">tp_account_manager_get_valid_accounts</a> (manager);

717

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-foreach">g_list_foreach</a> (accounts, (<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GFunc">GFunc</a>) <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);</pre></td>

718

</tr>

719

</tbody>

720

</table>

721

</div>

722

599

600

GList *accounts;

601

account = tp_account_manager_get_valid_accounts (manager);

602

g_list_foreach (accounts, (GFunc) g_object_ref, NULL);

603

</pre></div>

723

604

724

605

725

606

753

634

<hr>

754

635

755

636

<a name="tp-account-manager-get-most-available-presence"></a><h3>tp_account_manager_get_most_available_presence ()</h3>

756

<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> tp_account_manager_get_most_available_presence

637

757

638

(<code><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager</code>,

758

639

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **status</code>,

759

640

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **message</code>);</pre>

1522

1403

</div>

1523

1404

1524

1405

<hr>

1525

Generated by GTK-Doc V1.17.1</div>

1406

Generated by GTK-Doc V1.17</div>

1526

1407

</body>

1527

1408

</html>

b'\\ No newline at end of file'

Older »