mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-10 18:51:21 +03:00
45d498ef1f
The class FSD_Base64Decoder has been renamed to FSD_Base64. The new method FSD_Base64::Encode has been added. The method Decode has been improved for performance.
69 lines
3.5 KiB
C++
69 lines
3.5 KiB
C++
// Copyright (c) 2016-2019 OPEN CASCADE SAS
|
|
//
|
|
// This file is part of Open CASCADE Technology software library.
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify it under
|
|
// the terms of the GNU Lesser General Public License version 2.1 as published
|
|
// by the Free Software Foundation, with special exception defined in the file
|
|
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
|
|
// distribution for complete text of the license and disclaimer of any warranty.
|
|
//
|
|
// Alternatively, this file may be used under the terms of Open CASCADE
|
|
// commercial license or contractual agreement.
|
|
|
|
#ifndef _FSD_Base64_HeaderFile
|
|
#define _FSD_Base64_HeaderFile
|
|
|
|
#include <NCollection_Buffer.hxx>
|
|
#include <TCollection_AsciiString.hxx>
|
|
|
|
//! Tool for encoding/decoding base64 stream.
|
|
class FSD_Base64
|
|
{
|
|
public:
|
|
|
|
//! Function encoding a buffer to base64 string.
|
|
//! @param[out] theEncodedStr the place for encoded string. Terminating null is not put.
|
|
//! If it is NULL just return the needed size.
|
|
//! @param[in] theStrLen the length of the buffer theEncodedStr in bytes.
|
|
//! This value must not be less than value returned when theEncodedStr is NULL.
|
|
//! @param[in] theData the input binary data.
|
|
//! @param[in] theDataLen the length of input data in bytes.
|
|
//! @return the length of the encoded string not including terminating null.
|
|
//! If theStrLen is not enough for storing all data nothing is written and 0 is returned.
|
|
Standard_EXPORT static Standard_Size Encode (char* theEncodedStr,
|
|
const Standard_Size theStrLen,
|
|
const Standard_Byte* theData,
|
|
const Standard_Size theDataLen);
|
|
|
|
//! Function encoding a buffer to base64 string.
|
|
//! @param[in] theData the input binary data
|
|
//! @param[in] theDataLen the length of input data in bytes
|
|
//! @return Base64 encoded string.
|
|
Standard_EXPORT static TCollection_AsciiString Encode(const Standard_Byte* theData,
|
|
const Standard_Size theDataLen);
|
|
|
|
//! Function decoding base64 string.
|
|
//! @param[out] theDecodedData the place for decoded data.
|
|
//! If it is NULL just return the needed size.
|
|
//! @param[in] theDataLen the length of the buffer theDecodedData in bytes.
|
|
//! This value must not be less than value returned when theDecodedData is NULL.
|
|
//! @param[in] theEncodedStr the input encoded string.
|
|
//! @param[in] theStrLen the length of input encoded string.
|
|
//! @return the length of the decoded data in bytes. If theDataLen is not enough
|
|
//! for storing all data nothing is written and 0 is returned.
|
|
Standard_EXPORT static Standard_Size Decode (Standard_Byte* theDecodedData,
|
|
const Standard_Size theDataLen,
|
|
Standard_CString theEncodedStr,
|
|
const Standard_Size theStrLen);
|
|
|
|
//! Function decoding base64 string.
|
|
//! @param[in] theStr the input encoded string
|
|
//! @param[in] theLen the length of input encoded string
|
|
//! @return null handle in case of out of memory condition
|
|
Standard_EXPORT static Handle(NCollection_Buffer) Decode (Standard_CString theStr,
|
|
const Standard_Size theLen);
|
|
};
|
|
|
|
#endif // _FSD_Base64_HeaderFile
|