blob: 48dd70641e236992d8029ba84c2a22af087296f4 [file] [log] [blame]
/*
* Author: Jeff Thompson
*
* BSD license, See the LICENSE file for more information.
*/
#ifndef NDN_NAME_HPP
#define NDN_NAME_HPP
#include <vector>
#include "common.h"
#include "c/Name.h"
#include "encoding/BinaryXMLWireFormat.hpp"
namespace ndn {
class NameComponent {
public:
NameComponent(unsigned char * value, unsigned int valueLen)
: value_(value, value + valueLen)
{
}
/**
* Set the componentStruct to point to this component, without copying any memory.
* WARNING: The resulting pointer in componentStruct is invalid after a further use of this object which could reallocate memory.
* @param componentStruct the C ndn_NameComponent struct to receive the pointer.
*/
void get(struct ndn_NameComponent &componentStruct)
{
componentStruct.value = &value_[0];
componentStruct.valueLength = value_.size();
}
const std::vector<unsigned char> &getValue() const { return value_; }
private:
std::vector<unsigned char> value_;
};
class Name {
public:
Name() {
}
Name(const char *uri);
void encode(std::vector<unsigned char> &output, WireFormat &wireFormat)
{
wireFormat.encodeName(*this, output);
}
void encode(std::vector<unsigned char> &output)
{
encode(output, BinaryXMLWireFormat::instance());
}
void decode(const unsigned char *input, unsigned int inputLength, WireFormat &wireFormat)
{
wireFormat.decodeName(*this, input, inputLength);
}
void decode(const unsigned char *input, unsigned int inputLength)
{
decode(input, inputLength, BinaryXMLWireFormat::instance());
}
void decode(const std::vector<unsigned char> &input, WireFormat &wireFormat)
{
decode(&input[0], input.size(), wireFormat);
}
void decode(const std::vector<unsigned char> &input)
{
decode(&input[0], input.size());
}
/**
* Set the nameStruct to point to the components in this name, without copying any memory.
* WARNING: The resulting pointers in nameStruct are invalid after a further use of this object which could reallocate memory.
* @param nameStruct a C ndn_Name struct where the components array is already allocated.
*/
void get(struct ndn_Name &nameStruct);
/**
* Clear the name, and set the components by copying from the name struct.
* @param name a C ndn_Name struct
*/
void set(struct ndn_Name &nameStruct);
/**
* Add a new component, copying from value of length valueLength.
*/
void addComponent(unsigned char *value, unsigned int valueLength) {
components_.push_back(NameComponent(value, valueLength));
}
/**
* Clear all the components.
*/
void clear() {
components_.clear();
}
/**
* Get the number of components.
* @return the number of components
*/
unsigned int getComponentCount() {
return components_.size();
}
/**
* Encode this name as a URI.
* @return the encoded URI.
*/
std::string to_uri();
private:
std::vector<NameComponent> components_;
};
}
#endif