BLOG | DOCUMENTATION | TRAC

Home --> Documentations --> PJLIB Reference

Test: Exception Handling

This file provides implementation of exception_test(). It tests the functionality of the exception handling API.

Note
This test use static ID not acquired through proper registration. This is not recommended, since it may create ID collissions.

Scope of the Test

Some scenarios tested:

  • no exception situation
  • basic TRY/CATCH
  • multiple exception handlers
  • default handlers

This file is pjlib-test/exception.c

/* $Id$ */
/*
* Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com)
* Copyright (C) 2003-2008 Benny Prijono <benny@prijono.org>
*
* 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#include "test.h"
#if INCLUDE_EXCEPTION_TEST
#include <pjlib.h>
#ifdef _MSC_VER
#pragma warning(disable:4702) // warning C4702: unreachable code
#endif
#define ID_1 1
#define ID_2 2
static int throw_id_1(void)
{
PJ_THROW( ID_1 );
PJ_UNREACHED(return -1;)
}
static int throw_id_2(void)
{
PJ_THROW( ID_2 );
PJ_UNREACHED(return -1;)
}
static int try_catch_test(void)
{
int rc = -200;
PJ_THROW(ID_1);
}
rc = 0;
}
return rc;
}
static int throw_in_handler(void)
{
int rc = 0;
PJ_THROW(ID_1);
}
if (PJ_GET_EXCEPTION() != ID_1)
rc = -300;
else
PJ_THROW(ID_2);
}
return rc;
}
static int return_in_handler(void)
{
PJ_THROW(ID_1);
}
return 0;
}
return -400;
}
static int test(void)
{
int rc = 0;
/*
* No exception situation.
*/
}
rc = -3;
}
if (rc != 0)
return rc;
/*
* Basic TRY/CATCH
*/
rc = throw_id_1();
// should not reach here.
rc = -10;
}
int id = PJ_GET_EXCEPTION();
if (id != ID_1) {
PJ_LOG(3,("", "...error: got unexpected exception %d (%s)",
if (!rc) rc = -20;
}
}
if (rc != 0)
return rc;
/*
* Multiple exceptions handlers
*/
rc = throw_id_2();
// should not reach here.
rc = -25;
}
switch (PJ_GET_EXCEPTION()) {
case ID_1:
if (!rc) rc = -30;
break;
case ID_2:
if (!rc) rc = 0;
break;
default:
if (!rc) rc = -40;
break;
}
}
if (rc != 0)
return rc;
/*
* Test default handler.
*/
rc = throw_id_1();
// should not reach here
rc = -50;
}
switch (PJ_GET_EXCEPTION()) {
case ID_1:
if (!rc) rc = 0;
break;
default:
if (!rc) rc = -60;
break;
}
}
if (rc != 0)
return rc;
/*
* Nested handlers
*/
rc = try_catch_test();
}
rc = -70;
}
if (rc != 0)
return rc;
/*
* Throwing exception inside handler
*/
rc = -80;
int rc2;
rc2 = throw_in_handler();
if (rc2)
rc = rc2;
}
if (PJ_GET_EXCEPTION() == ID_2) {
rc = 0;
} else {
rc = -90;
}
}
if (rc != 0)
return rc;
/*
* Return from handler. Returning from the function inside a handler
* should be okay (though returning from the function inside the
* PJ_TRY block IS NOT OKAY!!). We want to test to see if handler
* is cleaned up properly, but not sure how to do this.
*/
int rc2;
rc2 = return_in_handler();
if (rc2)
rc = rc2;
}
rc = -100;
}
return 0;
}
int exception_test(void)
{
int i, rc;
enum { LOOP = 10 };
for (i=0; i<LOOP; ++i) {
if ((rc=test()) != 0) {
PJ_LOG(3,("", "...failed at i=%d (rc=%d)", i, rc));
return rc;
}
}
return 0;
}
#else
/* To prevent warning about "translation unit is empty"
* when this test is disabled.
*/
int dummy_exception_test;
#endif /* INCLUDE_EXCEPTION_TEST */
#define PJ_THROW(exception_id)
Definition: except.h:403
const char * pj_exception_id_name(pj_exception_id_t id)
#define PJ_TRY
Definition: except.h:374
#define PJ_GET_EXCEPTION()
Definition: except.h:410
#define PJ_UNUSED_ARG(arg)
Definition: config.h:1303
#define PJ_LOG(level, arg)
Definition: log.h:107
#define PJ_USE_EXCEPTION
Definition: except.h:368
#define PJ_END
Definition: except.h:395
#define PJ_CATCH_ANY
Definition: except.h:389

 


PJLIB Open Source, high performance, small footprint, and very very portable framework
Copyright (C) 2006-2009 Teluu Inc.