X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fodr.xml;h=627f5c91966e6af38424bc8e636af35aa1ae6f4d;hb=76f5f8bd7124c8643be25e0d9838e5897e19df8a;hp=0633205e602cf55012b621e38912aeedbcd90bef;hpb=db6b40fa96ba3c3cda68d143a17b5b1fd0a20eb4;p=yaz-moved-to-github.git diff --git a/doc/odr.xml b/doc/odr.xml index 0633205..627f5c9 100644 --- a/doc/odr.xml +++ b/doc/odr.xml @@ -1,4 +1,3 @@ - The ODR Module Introduction @@ -105,7 +104,7 @@ - void odr_reset(ODR o, int size); + void odr_reset(ODR o); @@ -322,23 +321,23 @@ void do_nothing_useful(int value) if (!(decode = odr_createmem(ODR_DECODE))) return; - valp = &value; - if (odr_integer(encode, &valp, 0, 0) == 0) + valp = &value; + if (odr_integer(encode, &valp, 0, 0) == 0) { printf("encoding went bad\n"); return; } - bufferp = odr_getbuf(encode, &len); - printf("length of encoded data is %d\n", len); + bufferp = odr_getbuf(encode, &len, 0); + printf("length of encoded data is %d\n", len); /* now let's decode the thing again */ - odr_setbuf(decode, bufferp, len); - if (odr_integer(decode, &resvalp, 0, 0) == 0) + odr_setbuf(decode, bufferp, len, 0); + if (odr_integer(decode, &resvalp, 0, 0) == 0) { printf("decoding went bad\n"); return; } - printf("the value is %d\n", *resvalp); + printf("the value is %d\n", *resvalp); /* clean up */ odr_destroy(encode); @@ -505,7 +504,7 @@ void do_nothing_useful(int value) Summary and Synopsis - #include <odr.h> + #include <yaz/odr.h> ODR odr_createmem(int direction); @@ -513,19 +512,17 @@ void do_nothing_useful(int value) void odr_reset(ODR o); - char *odr_getbuf(ODR o, int *len); + char *odr_getbuf(ODR o, int *len, int *size); - void odr_setbuf(ODR o, char *buf, int len); + void odr_setbuf(ODR o, char *buf, int len, int can_grow); void *odr_malloc(ODR o, int size); - ODR_MEM odr_extract_mem(ODR o); - - void odr_release_mem(ODR_MEM r); + NMEM odr_extract_mem(ODR o); int odr_geterror(ODR o); - void odr_perror(char *message); + void odr_perror(ODR o, const char *message); extern char *odr_errlist[]; @@ -759,9 +756,9 @@ int odr_oid(ODR o, Odr_oid **p, int optional, const char *name); The C OID representation is simply an array of integers, terminated by the value -1 (the Odr_oid type is synonymous with - the int type). + the short type). We suggest that you use the OID database module (see - ) to handle object identifiers + ) to handle object identifiers in your application.