Include/cStringIO.h

   1 #ifndef CSTRINGIO_INCLUDED
   2 #define CSTRINGIO_INCLUDED
   3 /*
   4
   5   cStringIO.h,v 1.4 1997/12/07 14:27:00 jim Exp
   6
   7   cStringIO C API
   8
   9      Copyright
  10
  11        Copyright 1996 Digital Creations, L.C., 910 Princess Anne
  12        Street, Suite 300, Fredericksburg, Virginia 22401 U.S.A. All
  13        rights reserved.  Copyright in this software is owned by DCLC,
  14        unless otherwise indicated. Permission to use, copy and
  15        distribute this software is hereby granted, provided that the
  16        above copyright notice appear in all copies and that both that
  17        copyright notice and this permission notice appear. Note that
  18        any product, process or technology described in this software
  19        may be the subject of other Intellectual Property rights
  20        reserved by Digital Creations, L.C. and are not licensed
  21        hereunder.
  22
  23      Trademarks
  24
  25        Digital Creations & DCLC, are trademarks of Digital Creations, L.C..
  26        All other trademarks are owned by their respective companies.
  27
  28      No Warranty
  29
  30        The software is provided "as is" without warranty of any kind,
  31        either express or implied, including, but not limited to, the
  32        implied warranties of merchantability, fitness for a particular
  33        purpose, or non-infringement. This software could include
  34        technical inaccuracies or typographical errors. Changes are
  35        periodically made to the software; these changes will be
  36        incorporated in new editions of the software. DCLC may make
  37        improvements and/or changes in this software at any time
  38        without notice.
  39
  40      Limitation Of Liability
  41
  42        In no event will DCLC be liable for direct, indirect, special,
  43        incidental, economic, cover, or consequential damages arising
  44        out of the use of or inability to use this software even if
  45        advised of the possibility of such damages. Some states do not
  46        allow the exclusion or limitation of implied warranties or
  47        limitation of liability for incidental or consequential
  48        damages, so the above limitation or exclusion may not apply to
  49        you.
  50
  51     If you have questions regarding this software,
  52     contact:
  53
  54       info@digicool.com
  55       Digital Creations L.C.
  56
  57       (540) 371-6909
  58
  59
  60   This header provides access to cStringIO objects from C.
  61   Functions are provided for calling cStringIO objects and
  62   macros are provided for testing whether you have cStringIO
  63   objects.
  64
  65   Before calling any of the functions or macros, you must initialize
  66   the routines with:
  67
  68     PycString_IMPORT
  69
  70   This would typically be done in your init function.
  71
  72 */
  73
  74 /* Basic fuctions to manipulate cStringIO objects from C */
  75
  76 static struct PycStringIO_CAPI {
  77
  78   /* Read a string.  If the last argument is -1, the remainder will be read. */
  79   int(*cread) Py_FPROTO((PyObject *, char **, int));
  80
  81   /* Read a line */
  82   int(*creadline) Py_FPROTO((PyObject *, char **));
  83
  84   /* Write a string */
  85   int(*cwrite) Py_FPROTO((PyObject *, char *, int));
  86
  87   /* Get the cStringIO object as a Python string */
  88   PyObject *(*cgetvalue) Py_FPROTO((PyObject *));
  89
  90   /* Create a new output object */
  91   PyObject *(*NewOutput) Py_FPROTO((int));
  92
  93   /* Create an input object from a Python string */
  94   PyObject *(*NewInput) Py_FPROTO((PyObject *));
  95
  96   /* The Python types for cStringIO input and output objects.
  97      Note that you can do input on an output object.
  98      */
  99   PyTypeObject *InputType, *OutputType;
 100
 101 } * PycStringIO = NULL;
 102
 103 /* These can be used to test if you have one */
 104 #define PycStringIO_InputCheck(O) \
 105   ((O)->ob_type==PycStringIO->InputType)
 106 #define PycStringIO_OutputCheck(O) \
 107   ((O)->ob_type==PycStringIO->OutputType)
 108
 109 static void *
 110 xxxPyCObject_Import(module_name, name)
 111   char *module_name;
 112   char *name;
 113 {
 114   PyObject *m, *c;
 115   void *r=NULL;
 116
 117   if((m=PyImport_ImportModule(module_name)))
 118     {
 119       if((c=PyObject_GetAttrString(m,name)))
 120         {
 121           r=PyCObject_AsVoidPtr(c);
 122           Py_DECREF(c);
 123         }
 124       Py_DECREF(m);
 125     }
 126
 127   return r;
 128 }
 129
 130 #define PycString_IMPORT \
 131   PycStringIO=xxxPyCObject_Import("cStringIO", "cStringIO_CAPI")
 132
 133 #endif /* CSTRINGIO_INCLUDED */