From 0425aadc78680e53000fd0108b540d6eca048516 Mon Sep 17 00:00:00 2001
From: gmcdonald
Date: Sat, 13 Feb 2010 01:32:03 +0000
Subject: Moving axis svn, part of TLP move INFRA-2441

git-svn-id: http://svn.apache.org/repos/asf/axis/axis2/c/core/trunk@909681 13f79535-47bb-0310-9956-ffa450edef68
---
 util/include/axutil_base64.h | 122 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 122 insertions(+)
 create mode 100644 util/include/axutil_base64.h

(limited to 'util/include/axutil_base64.h')

diff --git a/util/include/axutil_base64.h b/util/include/axutil_base64.h
new file mode 100644
index 0000000..d52e3af
--- /dev/null
+++ b/util/include/axutil_base64.h
@@ -0,0 +1,122 @@
+
+/*
+ *   Copyright 2003-2004 The Apache Software Foundation.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include <axutil_utils_defines.h>
+
+/*
+ * @file axutil_base64.h
+ * @brief AXIS2-UTIL Base64 Encoding
+ */
+#ifndef AXUTIL_BASE64_H
+#define AXUTIL_BASE64_H
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+    /*
+     * @defgroup AXIS2_Util_Base64 base64 encoding
+     * @ingroup AXIS2_Util
+     */
+
+    /* Simple BASE64 encode/decode functions.
+     *
+     * As we might encode binary strings, hence we require the length of
+     * the incoming plain source. And return the length of what we decoded.
+     *
+     * The decoding function takes any non valid char (i.e. whitespace, \0
+     * or anything non A-Z,0-9 etc as terminal.
+     *
+     * plain strings/binary sequences are not assumed '\0' terminated. Encoded
+     * strings are neither. But probably should.
+     *
+     */
+
+    /*
+     * Given the length of an un-encrypted string, get the length of the
+     * encrypted string.
+     * @param len the length of an unencrypted string.
+     * @return the length of the string after it is encrypted
+     */
+    AXIS2_EXTERN int AXIS2_CALL
+    axutil_base64_encode_len(
+        int len);
+
+    /*
+     * Encode a text string using base64encoding.
+     * @param coded_dst The destination string for the encoded string.
+     * @param plain_src The original string in plain text
+     * @param len_plain_src The length of the plain text string
+     * @return the length of the encoded string
+     */
+    AXIS2_EXTERN int AXIS2_CALL
+    axutil_base64_encode(
+        char *coded_dst,
+        const char *plain_src,
+        int len_plain_src);
+
+    /*
+     * Encode an EBCDIC string using base64encoding.
+     * @param coded_dst The destination string for the encoded string.
+     * @param plain_src The original string in plain text
+     * @param len_plain_src The length of the plain text string
+     * @return the length of the encoded string
+     */
+    AXIS2_EXTERN int AXIS2_CALL
+    axutil_base64_encode_binary(
+        char *coded_dst,
+        const unsigned char *plain_src,
+        int len_plain_src);
+
+    /*
+     * Determine the length of a plain text string given the encoded version
+     * @param coded_src The encoded string
+     * @return the length of the plain text string
+     */
+    AXIS2_EXTERN int AXIS2_CALL
+    axutil_base64_decode_len(
+        const char *coded_src);
+
+    /*
+     * Decode a string to plain text
+     * @param plain_dst The destination string for the plain text. size of this should be axutil_base64_decode_len + 1
+     * @param coded_src The encoded string
+     * @return the length of the plain text string
+     */
+    AXIS2_EXTERN int AXIS2_CALL
+    axutil_base64_decode(
+        char *plain_dst,
+        const char *coded_src);
+
+    /*
+     * Decode an EBCDIC string to plain text
+     * @param plain_dst The destination string for the plain text. size of this should be axutil_base64_decode_len
+     * @param coded_src The encoded string
+     * @return the length of the plain text string
+     */
+    AXIS2_EXTERN int AXIS2_CALL
+    axutil_base64_decode_binary(
+        unsigned char *plain_dst,
+        const char *coded_src);
+
+    /* @} */
+#ifdef __cplusplus
+}
+#endif
+
+#endif                          /* !AXIS2_BASE64_H */
-- 
cgit v1.1-32-gdbae