rapidxml::xml_base::name

[metoda] Ustawia lub pobiera nazwę elementu.

Składnia

#include <rapidxml.hpp>

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

Parametry szablonu

Parametr	Opis
Ch	Typ danych przechowujący pojedynczy znak.

Argumenty

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

Zwracana wartość

Pierwsza funkcja zwraca nazwę elementu lub pusty łańcuch znaków, jeśli element nie ma nazwy. 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 nazwa zwrócona przez pierwszą funkcję nie będzie zakończona znakiem zerowym.

Obiekt typu

xml_base

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

memory_pool

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

Zagadnienia powiązane

value	Ustawia lub pobiera wartość 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.