Файл pistring.h

Класс строки Подробнее...

#include "pibytearray.h"
#include "piconstchars.h"

Классы
class	PIString
	Класс строки. Подробнее...

Функции
PIString	operator+ (const PIString &str, const PIString &f)
	Возвращает соединение строк.
PIString	operator+ (const PIString &f, const char *str)
	Возвращает соединение строк.
PIString	operator+ (const char *str, const PIString &f)
	Возвращает соединение строк.
PIString	operator+ (const char c, const PIString &f)
	Возвращает соединение строк.
PIString	operator+ (const PIString &f, const char c)
	Возвращает соединение строк.
int	versionCompare (const PIString &v0, const PIString &v1, int components=6)
	Сравнивает две строки с версиями в произвольной форме и возвращает 0, -1 или 1. Подробнее...
PIString	versionNormalize (const PIString &v)
	Преобразует строку с версией в произвольной форме к классическому виду. Подробнее...
template<typename T >
PIString	piStringify (const T &v)
	Возвращает строковое представление "v", используя PICout operator<<(T)

Переменные
return	s
	Оператор сохранения.
v	changed_ = true
	Оператор извлечения.

Подробное описание

Класс строки

Функции

versionCompare()

int versionCompare	(	const PIString &	v0,
		const PIString &	v1,
		int	components = 6
	)

Сравнивает две строки с версиями в произвольной форме и возвращает 0, -1 или 1.

Этот метод разбирает версии на числовые части и метку. Затем сравнивает не более чем "components" частей. Если различий нет, то сравниваются метки. Каждой метке соответствует своё значение так, что "prealpha" < "alpha" < "prebeta" < "beta" < "rc[N]" < "" < "r[N]". Пример:

piCout << versionCompare("1.0.0_rc2-999", "1.0.1_rc2-999"); // -1, <
piCout << versionCompare("1.0.0", "0.9.2"); // 1, >
piCout << versionCompare("1.0.0_r1", "1.0.0"); // 1, >
piCout << versionCompare("1.0.0_r1", "1.0.0", 3); // 0, =
piCout << versionCompare("1.0.0_r2", "1.0.0", 3); // 0, =
piCout << versionCompare(".2-alpha", "0.2_alpha"); // 0, =
piCout << versionCompare("1_prebeta", "1.0_alpha"); // 1, >

Возвращает

• 0 - равны
• 1 - v0 > v1
• -1 - v0 < v1

versionNormalize()

PIString versionNormalize

(

const PIString &

v

)

Преобразует строку с версией в произвольной форме к классическому виду.

Разбирает версию по описанию versionCompare() и возвращает классическое представление версии и метки: major.minor.revision[-build][_label]. Пример:

piCout << versionNormalize(""); // 0.0.0
piCout << versionNormalize("1"); // 1.0.0
piCout << versionNormalize("1.2"); // 1.2.0
piCout << versionNormalize("1.2.3"); // 1.2.3
piCout << versionNormalize("1.2+rc1.99"); // 1.2.99_rc1
piCout << versionNormalize("1.2-alpha"); // 1.2.0_alpha
piCout << versionNormalize("1..4_rc2-999"); // 1.0.4-999_rc2