/**
 * Copyright - See the COPYRIGHT that is included with this distribution.
 * pvAccessCPP is distributed subject to a Software License Agreement found
 * in file LICENSE that is included with this distribution.
 */

#ifndef HEXDUMP_H_
#define HEXDUMP_H_

#ifdef epicsExportSharedSymbols
#   define hexDumpEpicsExportSharedSymbols
#   undef epicsExportSharedSymbols
#endif

#include <pv/pvType.h>

#ifdef	hexDumpEpicsExportSharedSymbols
#   define epicsExportSharedSymbols
#   undef hexDumpEpicsExportSharedSymbols
#endif

#include <shareLib.h>

namespace epics {
namespace pvAccess {

/**
 * Output a buffer in hex format.
 * @param name  name (description) of the message.
 * @param bs    buffer to dump
 * @param len   first bytes (length) to dump.
 */
epicsShareFunc void hexDump(std::string const & name, const epics::pvData::int8 *bs, int len);

/**
 * Output a buffer in hex format.
 * @param[in] name  name (description) of the message.
 * @param[in] bs    buffer to dump
 * @param[in] start dump message using given offset.
 * @param[in] len   first bytes (length) to dump.
 */
epicsShareFunc void hexDump(std::string const & name, const epics::pvData::int8 *bs, int start, int len);

/**
 * Output a buffer in hex format.
 * @param[in] prologue string to prefixed to debug output, can be <code>null</code>
 * @param[in] name  name (description) of the message.
 * @param[in] bs    buffer to dump
 * @param[in] start dump message using given offset.
 * @param[in] len   first bytes (length) to dump.
 */
epicsShareFunc void hexDump(std::string const & prologue, std::string const & name,
                            const epics::pvData::int8 *bs, int start, int len);

}
}

#endif /* HEXDUMP_H_ */