| 1 | /** |
|---|
| 2 | * @copyright |
|---|
| 3 | * ==================================================================== |
|---|
| 4 | * Copyright (c) 2000-2004, 2008 CollabNet. All rights reserved. |
|---|
| 5 | * |
|---|
| 6 | * This software is licensed as described in the file COPYING, which |
|---|
| 7 | * you should have received as part of this distribution. The terms |
|---|
| 8 | * are also available at http://subversion.tigris.org/license-1.html. |
|---|
| 9 | * If newer versions of this license are posted there, you may use a |
|---|
| 10 | * newer version instead, at your option. |
|---|
| 11 | * |
|---|
| 12 | * This software consists of voluntary contributions made by many |
|---|
| 13 | * individuals. For exact contribution history, see the revision |
|---|
| 14 | * history and logs, available at http://subversion.tigris.org/. |
|---|
| 15 | * ==================================================================== |
|---|
| 16 | * @endcopyright |
|---|
| 17 | * |
|---|
| 18 | * @file svn_quoprint.h |
|---|
| 19 | * @brief quoted-printable encoding and decoding functions. |
|---|
| 20 | */ |
|---|
| 21 | |
|---|
| 22 | #ifndef SVN_QUOPRINT_H |
|---|
| 23 | #define SVN_QUOPRINT_H |
|---|
| 24 | |
|---|
| 25 | #include <apr_pools.h> |
|---|
| 26 | |
|---|
| 27 | #include "svn_string.h" /* for svn_strinbuf_t */ |
|---|
| 28 | #include "svn_io.h" /* for svn_stream_t */ |
|---|
| 29 | |
|---|
| 30 | #ifdef __cplusplus |
|---|
| 31 | extern "C" { |
|---|
| 32 | #endif /* __cplusplus */ |
|---|
| 33 | |
|---|
| 34 | /** Return a writable generic stream which will encode binary data in |
|---|
| 35 | * quoted-printable format and write the encoded data to @a output. Be |
|---|
| 36 | * sure to close the stream when done writing in order to squeeze out |
|---|
| 37 | * the last bit of encoded data. |
|---|
| 38 | */ |
|---|
| 39 | svn_stream_t * |
|---|
| 40 | svn_quoprint_encode(svn_stream_t *output, |
|---|
| 41 | apr_pool_t *pool); |
|---|
| 42 | |
|---|
| 43 | /** Return a writable generic stream which will decode binary data in |
|---|
| 44 | * quoted-printable format and write the decoded data to @a output. Be |
|---|
| 45 | * sure to close the stream when done writing in order to squeeze out |
|---|
| 46 | * the last bit of encoded data. |
|---|
| 47 | */ |
|---|
| 48 | svn_stream_t * |
|---|
| 49 | svn_quoprint_decode(svn_stream_t *output, |
|---|
| 50 | apr_pool_t *pool); |
|---|
| 51 | |
|---|
| 52 | |
|---|
| 53 | /** Simpler interface for encoding quoted-printable data assuming we have all |
|---|
| 54 | * of it present at once. The returned string will be allocated from @a pool. |
|---|
| 55 | */ |
|---|
| 56 | svn_stringbuf_t * |
|---|
| 57 | svn_quoprint_encode_string(const svn_stringbuf_t *str, |
|---|
| 58 | apr_pool_t *pool); |
|---|
| 59 | |
|---|
| 60 | /** Simpler interface for decoding quoted-printable data assuming we have all |
|---|
| 61 | * of it present at once. The returned string will be allocated from @a pool. |
|---|
| 62 | */ |
|---|
| 63 | svn_stringbuf_t * |
|---|
| 64 | svn_quoprint_decode_string(const svn_stringbuf_t *str, |
|---|
| 65 | apr_pool_t *pool); |
|---|
| 66 | |
|---|
| 67 | |
|---|
| 68 | #ifdef __cplusplus |
|---|
| 69 | } |
|---|
| 70 | #endif /* __cplusplus */ |
|---|
| 71 | |
|---|
| 72 | #endif /* SVN_QUOPRINT_H */ |
|---|
