Skip to main content

C++ of the Day #12 - Boost.Python 사용하기 #3

지난번 글들 ((http://ideathinking.com/blog/?p=35
http://ideathinking.com/blog/?p=38)) 에 이어 이번에는 Boost.Python에서 C++ 함수 사용시에 신경써야 할 점 몇가지를 알아보겠습니다.

Call Policies

먼저 이해를 돕기 위해 이전에 사용했던 Point 클래스에 아래의 두개의 함수를 추가합니다.
Point* clone() const {
  return new Point(x, y);
}

Point& get_this() {
  return *this;
}
clone() 함수는 자신을 그대로 복제한 새로운 객체를 리턴하는 함수이고 get_this()는 자신을 그대로 리턴합니다. 하지만 python에서는 함수가 리턴하는 것이
  1. 새로 생성된 객체인지
    - 이 경우 python 런타임은 이 객체를 새로운 obejct로써 관리해야 합니다.
  2. 기존에 있던 객체인지
    - 이 경우에는 기존의 객체와 이 객체를 같은 object로써 관리해야 합니다.
를 알아야 합니다.

따라서 다음과 같이 python에게 실제 리턴되는 객체의 특성을 설명해주어야 합니다.
.def("clone", &Point::clone, return_value_policy())
.def("get_this", &Point::get_this, return_value_policy())

위의 선언을 통해 clone() 함수는 새로 생성된 객체 포인터를 리턴하고 get_this() 는 기존의 객체를 리턴한다는 것을 python에 알려줄 수 있습니다.

그럼 실행해보기에 앞서 실제 객체의 lifetime이 어떻게 되는지 알아보기 위해 Point 클래스의 소멸자에 cout을 넣도록 하겠습니다.
virtual ~Point() {
  std::cout << "~Point()" << std::endl;
}
다음은 실행 결과입니다.
>>> from point import Point
>>> x = Point(1,2)
>>> y = x.clone()
>>> print x
<point.Point object at 0xf656ffcc>
>>> print y
<point.Point object at 0xf656bc34>
>>> del x
~Point()
>>> del y
~Point()
>>> x = Point(1,2)
>>> y = x.get_this()
>>> print x
<point.Point object at 0xf656ffcc>
>>> print y

>>> del x
>>> del y
~Point()
예상대로 잘 동작함을 확인할 수 있습니다. 더 자세한 내용은 Functions::Call Policies 문서를 참고하세요.


Overloading

Overloading에 대해 알아보기 위해 Point 클래스를 다음과 같이 수정하였습니다.
class Point
{
public:
  Point(int x = 0, int y = 0) : x_(x), y_(y) {
  }
  void x(int x) {
    x_ = x;
  }
  void y(int y) {
    y_ = y;
  }
  int x() const {
    return x_;
  }
  int y() const {
    return y_;
  }
  std::string to_s() const {
    std::ostringstream ss;
    ss << "(" << std::dec << x_ << ", " << y_ << ")";
    return ss.str();
  }
private:
  int x_, y_;
};
보시는 바와 같이 'x'라는 이름으로 get/set 함수를 모두 만들었습니다. 이를 python에서 이용하게 하려면 어떻게 해야 할까요? 애석하게도 이를 위해서는 다음과 같이 손으로 함수 포인터를 다른 이름으로 선언해주어야 합니다. 물론 원래 Point 클래스는 바꾸지 않는 작업입니다.
int (Point::*get_x)() const = &Point::x;
int (Point::*get_y)() const = &Point::y;
void (Point::*set_x)(int)   = &Point::x;
void (Point::*set_y)(int)   = &Point::y;
이를 이용해서 다음과 같이 python에 property를 사용할 수 있습니다.
BOOST_PYTHON_MODULE(point)
{
class_<point>("Point", init<optional<int, int> >())
.add_property("x", get_x, set_x)
.add_property("y", get_y, set_y)
.def("to_s", &Point::to_s)
;
}
사용 예제는 다음과 같습니다.
>>> from point import Point
>>> x = Point()
>>> x.x = 1
>>> x.y = 2
>>> x.x
1
>>> x.y
2
>>> x.to_s()
'(1, 2)'

Default Arguments

자. 이번엔 default arguments에 대해 알아보기 위해 Point 클래스에 다음과 같은 함수를 추가해보겠습니다.
void set(int x = 0, int y = 0) {
  x_ = x;
  y_ = y;
}
이 경우 다음과 같은 helper macro를 사용하여 쉽게 python에서 사용할 수 있습니다.
BOOST_PYTHON_MEMBER_FUNCTION_OVERLOADS(Point_overloads, set, 0, 2);
...
.def("set", &Point::set, Point_overloads())
...
이 매크로에서 사용된 세번째와 네번째 인자인 0과 2는 각각 해당 함수가 받아들일 수 있는 최소와 최대 인자의 갯수입니다. set() 함수의 경우에는 두개의 인자 모두가 default 값을 가지고 있기 때문에 0 과 2 가 되죠. 생성자에서 사용되는 default arguments의 경우에는 optional이라는 문법을 사용하면 됩니다. 이에 대해선 이전 글의 생성자 사용하기부분을 참고하세요.

Conclusion

조금 까다로운 부분을 알아볼수록 사용자가 해주어야 할 작업이 많아짐을 알 수 있습니다. 하지만 그냥 Python/C API를 쓰는 것에 비하면 별것 아니기도 하거니와 pyste 프로젝트가 완성되면 이런 잡다한 작업들도 자동으로 이루어질 것으로 기대됩니다.

Comments

Popular posts from this blog

1의 개수 세기

저도 간단한 알고리즘 문제 하나... :-)

어떤 수 n이 주어졌을때 1~n까지의 수를 쭈욱 썼을때 나오는 1의 개수를 구하는 문제입니다.

예를 들어 13이라는 수가 주어지면 1~13까지의 수 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13에서 1은 1, 10, 11, 12, 13에 나오며 그 개수는 6이 됩니다. 즉, f(13)=6.

원래 문제는 f(n)=n이 되는 1이 아닌 가장 작은 수를 구하는 문제인데 이 문제의 경우에는 처음부터 쭈욱 세어나가면 되기 때문에 간단히 다음과 같이 구현을 하면 됩니다. ((한가지 주의할 점은 이전에 찾았던 n-1값을 사용하지 않고 다시 처음부터 n까지 값을 계산하면 시간이 너무 많이 걸린다는 점입니다. 위의 코드에서는 static 변수를 사용하여 이전 값에 계속 더해나가는 방법을 사용했습니다.))


#include

int count1(int n)
{
static int cnt = 1; // not 0 because n starts from 2. see main.

while (n > 0) {
if ((n % 10) == 1) ++cnt;
n /= 10;
}

return cnt;
}

int main()
{
using namespace std;

int n = 2;

while (count1(n) != n) ++n;
cout << n << endl;
}


좀 재미가 없죠? 그래서 이번 문제는 어떤 수 n에 대해서 f(n)을 O(1)시간에 구하는 알고리즘을 만드는 것입니다. 관심있으신 분들은 한번 풀어보세요. 제가 만든 코드는 내일 올려보겠습니다.

C++ of the Day #9 - Boost.Python 사용하기 #1

Python은 가장 인기있는 interpret 언어중의 하나입니다. Python의 장점 중 하나는 C/C++ 모듈과 쉽게 연동할 수 있다는 점입니다. 물론 손으로 일일히 wrapper를 만드는 것은 손이 많이 가고 에러를 만들수 있는 작업이나 SWIG등과 같은 도구를 사용하면 쉽게 python 모듈을 만들 수 있습니다.

Boost.Python은 이런 SWIG와 같이 python 모듈을 쉽게 만들 수 있도록 도와주는 라이브러리로 순수 C++만을 사용한다는 점이 SWIG와 다른 점입니다. 그리고 개인적으로는 Boost 라이브러리에 포함되어 있는 것들이 왠지 좀 더 믿음직스러워서... :-)

이번 글에서는 Boost.Python 문서에 나와 있는 예제를 가지고 간단하게 python 모듈을 만드는 방법에 대해서 알아보겠습니다.

Requirements리눅스
이 글에서는 리눅스 환경에서의 사용 방법을 설명한다.Boost.Python 라이브러리 (1.33.1)
Boost 라이브러리를 다운로드받아 아래와 유사한 명령으로 라이브러리를 빌드한다.
bjam -sTOOLS=gcc -with-python install

bjam의 --prefix 옵션으로 라이브러리가 설치될 위치를 변경할 수 있다.Python 라이브러리 (2.4.3)
Python을 다운로드 받아 빌드하여 설치한다.
위의 경우와 유사하게 configure의 --prefix 옵션으로 설치될 위치를 변경할 수 있다.

Write C++ Code다음과 같이 코드를 작성한다.

// greet.cpp #include <stdexcept> char const* greet(unsigned x) { static char const* const msgs[] = { "hello", "Boost.Python", "world!" }; if (x > 2) throw std::range_error("greet: index out of range"…

Hello Wordpress, again.

한 두주일 정도 Textpattern을 사용해봤는데 다시 Wordpress로 돌아오기로 결정했습니다. 무엇보다 스킨 변경이 너무 복잡하고 사용자층이 Wordpress에 비해 너무 앏네요. 원하는 plugin도 찾기 어렵고... :-|

그동안 Textpattern에 썼던 글들은 모두 Wordpress로 옮겼습니다. 2개 있던 댓글도 옮겼는데 그중의 하난 제가 쓴... ;-)

애초에 wp-dokuwiki plugin이 무거워서 옮겼던 것이라 이 plugin은 설치를 안할 예정인데 몇가지 아쉬운 점이 있네요.

첫째는 code highlighting 기능인데 이 기능은 예전에 만들어 놨던 것을 조금 수정해서 쓰려고 준비중입니다. 두번째는 Footnote 기능인데 찾아보니 Footnotes 0.9 Plugin for WordPress 2.0.x라는게 있네요.

이정도면 비록 wiki syntax에 비할바는 아니지만 쓸만할 것 같습니다. :-)