rapidxml::xml_base::value

[metoda] Ustawia lub pobiera wartość elementu.

Składnia

#include <rapidxml.hpp>

namespace rapidxml
{
template < class Ch = char >
class xml_base
{
public:
Ch * value() const; //1
void value( const Ch * value, std::size_t size ); //2
void value( const Ch * value ); //3
};
}

Parametry szablonu

Parametr	Opis
Ch	Typ danych przechowujący pojedynczy znak.

Argumenty

Argument	Opis
value	Wartość elementu do ustawienia. Trzecia funkcja wymaga wartości zakończonej znakiem zerowym, natomiast druga określa długość wartości na podstawie argumentu `size`.
size	Rozmiar wartości (w znakach) bez uwzględniania znaku zerowego.

Zwracana wartość

Pierwsza funkcja zwraca wartość elementu lub pusty łańcuch znaków, jeśli element nie ma wartości. Druga i trzecia funkcja niczego nie zwraca.

Dodatkowe informacje

Jeśli podczas przetwarzania danych została użyta flaga

rapidxml::parse_no_string_terminators

, to zwrócona wartość nie będzie zakończona znakiem zerowym.

Obiekt typu

xml_base

nie jest właścicielem wartości (tylko przechowuje wskaźnik do niej). Podczas usuwania obiektu pamięć przydzielona na przechowywanie wartości nie jest zwalniana. Programista odpowiada za czas istnienia wartości oraz za przydzielenie i zwolnienie pamięci na nią. Najlepszym sposobem jest wykorzystanie typu

memory_pool

powiązanego z dokumentem do przydzielenia miejsca na wartość. W ten sposób wartość będzie istniała, dopóki dokument nie zostanie usunięty.

Zagadnienia powiązane

name	Ustawia lub pobiera nazwę elementu. (metoda)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.