ClickHouse/libs/libmysqlxx/include/mysqlxx/Row.h

#pragma once

#include <mysqlxx/Types.h>
#include <mysqlxx/String.h>
#include <mysqlxx/ResultBase.h>


namespace mysqlxx
{

class ResultBase;


/** Строка результата.
  * В отличие от mysql++,
  *  представляет собой обёртку над MYSQL_ROW (char**), ссылается на ResultBase, не владеет сам никакими данными.
  * Это значит, что если будет уничтожен объект результата или соединение,
  *  или будет задан следующий запрос, то Row станет некорректным.
  * При использовании UseQueryResult, в памяти хранится только одна строка результата,
  *  это значит, что после чтения следующей строки, предыдущая становится некорректной.
  */
class Row
{
private:
	/** @brief Pointer to bool data member, for use by safe bool conversion operator.
	  * @see http://www.artima.com/cppsource/safebool.html
	  * Взято из mysql++.
	  */
	typedef MYSQL_ROW Row::*private_bool_type;

public:
	/** Для возможности отложенной инициализации. */
	Row()
	{
	}

	/** Для того, чтобы создать Row, используйте соответствующие методы UseQueryResult или StoreQueryResult. */
	Row(MYSQL_ROW row_, ResultBase * res_, MYSQL_LENGTHS lengths_)
		: row(row_), res(res_), lengths(lengths_)
	{
	}

	/** Получить значение по индексу.
	  * Здесь используется int, а не unsigned, чтобы не было неоднозначности с тем же методом, принимающим const char *.
	  */
	String operator[] (int n) const
	{
		if (unlikely(static_cast<size_t>(n) >= res->getNumFields()))
			throw Exception("Index of column is out of range.");
		return String(row[n], lengths[n], res);
	}

	/** Получить значение по имени. Слегка менее эффективно. */
	String operator[] (const char * name) const
	{
		unsigned n = res->getNumFields();
		MYSQL_FIELDS fields = res->getFields();

		for (unsigned i = 0; i < n; ++i)
			if (!strcmp(name, fields[i].name))
				return operator[](i);

		throw Exception(std::string("Unknown column ") + name);
	}

	/** Получить значение по индексу. */
	String at(size_t n) const
	{
		return operator[](n);
	}

	/** Количество столбцов. */
	size_t size() const { return res->getNumFields(); }

	/** Является ли пустым? Такой объект используется, чтобы обозначить конец результата
	  * при использовании UseQueryResult. Или это значит, что объект не инициализирован.
	  * Вы можете использовать вместо этого преобразование в bool.
	  */
	bool empty() const { return row == nullptr; }

	/** Преобразование в bool.
	  * (Точнее - в тип, который преобразуется в bool, и с которым больше почти ничего нельзя сделать.)
	  */
	operator private_bool_type() const	{ return row == nullptr ? NULL : &Row::row; }

private:
	MYSQL_ROW row = nullptr;
	ResultBase * res = nullptr;
	MYSQL_LENGTHS lengths;
};

}