#include <QMetaEnum>
#include <cfloat>
#include <memory>
#include <cmath>
#include "qgis_core.h"
#include "qgis_sip.h"

Include dependency graph for qgis.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	Qgis
	Provides global constants and enumerations for use throughout the application. More...

class	QgsSignalBlocker< Object >
	RAII signal blocking class. More...

Macros
#define	BUILTIN_UNREACHABLE

#define	cast_to_fptr(f) f

#define	MAYBE_UNUSED

#define	NODISCARD Q_REQUIRED_RESULT

#define	Q_NOWARN_DEPRECATED_POP

#define	Q_NOWARN_DEPRECATED_PUSH

#define	Q_NOWARN_UNREACHABLE_POP

#define	Q_NOWARN_UNREACHABLE_PUSH

#define	QGISEXTERN extern "C"

#define	QHASH_FOR_CLASS_ENUM(T)

Typedefs
typedef unsigned long long	qgssize
	Qgssize is used instead of size_t, because size_t is stdlib type, unknown by SIP, and it would be hard to define size_t correctly in SIP.

typedef QMap< QString, QString >	QgsStringMap

Functions
bool	operator< (const QVariant &v1, const QVariant &v2)
	Compares two QVariant values and returns whether the first is less than the second.

bool	operator> (const QVariant &v1, const QVariant &v2)
	Compares two QVariant values and returns whether the first is greater than the second.

bool	qgsDoubleNear (double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
	Compare two doubles (but allow some difference)

bool	qgsDoubleNearSig (double a, double b, int significantDigits=10)
	Compare two doubles using specified number of significant digits.

QString	qgsDoubleToString (double a, int precision=17)
	Returns a string representation of a double.

template<class T >
T	qgsEnumKeyToValue (const QString &key, const T &defaultValue, bool tryValueAsKey=true, bool *returnOk=nullptr)
	Returns the value corresponding to the given key of an enum.

template<class T >
const QList< T >	qgsEnumList ()
	Returns a list all enum entries.

template<class T >
const QMap< T, QString >	qgsEnumMap ()
	Returns a map of all enum entries.

template<class T >
QString	qgsEnumValueToKey (const T &value, bool *returnOk=nullptr)
	Returns the value for the given key of an enum.

template<class T >
T	qgsFlagKeysToValue (const QString &keys, const T &defaultValue, bool tryValueAsKey=true, bool *returnOk=nullptr)
	Returns the value corresponding to the given keys of a flag.

template<class T >
QString	qgsFlagValueToKeys (const T &value, bool *returnOk=nullptr)
	Returns the value for the given keys of a flag.

bool	qgsFloatNear (float a, float b, float epsilon=4 *FLT_EPSILON)
	Compare two floats (but allow some difference)

void CORE_EXPORT	qgsFree (void *ptr)
	Frees the memory space pointed to by ptr.

void CORE_EXPORT *	qgsMalloc (size_t size)
	Allocates size bytes and returns a pointer to the allocated memory.

template<class Key , class Value >
QString	qgsMapJoinKeys (const QMap< Key, Value > &map, const QString &separator)
	Joins all the map keys into a single string with each element separated by the given separator.

template<class Key , class Value >
QString	qgsMapJoinValues (const QMap< Key, Value > &map, const QString &separator)
	Joins all the map values into a single string with each element separated by the given separator.

bool	qgsNanCompatibleEquals (double a, double b)
	Compare two doubles, treating nan values as equal.

template<typename T >
bool	qgsNumberNear (T a, T b, T epsilon=std::numeric_limits< T >::epsilon() *4)
	Compare two numbers of type T (but allow some difference)

CORE_EXPORT double	qgsPermissiveToDouble (QString string, bool &ok)
	Converts a string to a double in a permissive way, e.g., allowing for incorrect numbers of digits between thousand separators.

CORE_EXPORT int	qgsPermissiveToInt (QString string, bool &ok)
	Converts a string to an integer in a permissive way, e.g., allowing for incorrect numbers of digits between thousand separators.

CORE_EXPORT qlonglong	qgsPermissiveToLongLong (QString string, bool &ok)
	Converts a string to an qlonglong in a permissive way, e.g., allowing for incorrect numbers of digits between thousand separators.

double	qgsRound (double number, int places)
	Returns a double number, rounded (as close as possible) to the specified number of places.

template<class T >
QString	qgsSetJoin (const QSet< T > &set, const QString &separator)
	Joins all the set values into a single string with each element separated by the given separator.

CORE_EXPORT bool	qgsVariantEqual (const QVariant &lhs, const QVariant &rhs)
	Compares two QVariant values and returns whether they are equal, two NULL values are always treated as equal and 0 is not treated as equal with NULL.

CORE_EXPORT bool	qgsVariantGreaterThan (const QVariant &lhs, const QVariant &rhs)
	Compares two QVariant values and returns whether the first is greater than the second.

CORE_EXPORT bool	qgsVariantLessThan (const QVariant &lhs, const QVariant &rhs)
	Compares two QVariant values and returns whether the first is less than the second.

Q_DECL_DEPRECATED CORE_EXPORT QString	qgsVsiPrefix (const QString &path)
	Returns a the vsi prefix which corresponds to a file path, or an empty string if the path is not associated with a vsi prefix.

CORE_EXPORT uint	qHash (const QVariant &variant)
	Hash for QVariant.

template<class Object >
QgsSignalBlocker< Object >	whileBlocking (Object *object)
	Temporarily blocks signals from a QObject while calling a single method from the object.

Variables
Q_DECL_DEPRECATED const long	GEO_EPSG_CRS_ID = 4326
	Numeric ID for the EPSG:4326 geographic coordinate system.

Q_DECL_DEPRECATED const long	GEOCRS_ID = 3452
	Numeric ID for the EPSG:4326 geographic coordinate system in QGIS internal srs database.

Q_DECL_DEPRECATED const long	GEOSRID = 4326
	Numeric ID for the EPSG:4326 geographic coordinate system.

Macro Definition Documentation

◆ BUILTIN_UNREACHABLE

#define BUILTIN_UNREACHABLE

Definition at line 6896 of file qgis.h.

◆ cast_to_fptr

#define cast_to_fptr ( f ) f

Definition at line 6138 of file qgis.h.

◆ MAYBE_UNUSED

#define MAYBE_UNUSED

Definition at line 6871 of file qgis.h.

◆ NODISCARD

#define NODISCARD Q_REQUIRED_RESULT

Definition at line 6855 of file qgis.h.

◆ Q_NOWARN_DEPRECATED_POP

#define Q_NOWARN_DEPRECATED_POP

Definition at line 6819 of file qgis.h.

◆ Q_NOWARN_DEPRECATED_PUSH

#define Q_NOWARN_DEPRECATED_PUSH

Definition at line 6818 of file qgis.h.

◆ Q_NOWARN_UNREACHABLE_POP

#define Q_NOWARN_UNREACHABLE_POP

Definition at line 6821 of file qgis.h.

◆ Q_NOWARN_UNREACHABLE_PUSH

#define Q_NOWARN_UNREACHABLE_PUSH

Definition at line 6820 of file qgis.h.

◆ QGISEXTERN

#define QGISEXTERN extern "C"

Definition at line 6833 of file qgis.h.

◆ QHASH_FOR_CLASS_ENUM

#define QHASH_FOR_CLASS_ENUM ( T )

Value:

  inline uint qHash(const T &t, uint seed) { \
    return ::qHash(static_cast<typename std::underlying_type<T>::type>(t), seed); \
  }

Definition at line 43 of file qgis.h.

Typedef Documentation

◆ qgssize

typedef unsigned long long qgssize

Qgssize is used instead of size_t, because size_t is stdlib type, unknown by SIP, and it would be hard to define size_t correctly in SIP.

Currently used "unsigned long long" was introduced in C++11 (2011) but it was supported already before C++11 on common platforms. "unsigned long long int" gives syntax error in SIP. KEEP IN SYNC WITH qgssize defined in SIP!

Definition at line 6790 of file qgis.h.

◆ QgsStringMap

typedef QMap<QString, QString> QgsStringMap

Definition at line 6780 of file qgis.h.

Function Documentation

◆ operator<()

bool operator<	(	const QVariant &	v1,
		const QVariant &	v2
	)

inline

Compares two QVariant values and returns whether the first is less than the second.

Useful for sorting lists of variants, correctly handling sorting of the various QVariant data types (such as strings, numeric values, dates and times)

Invalid < NULL < Values

See also: qgsVariantGreaterThan()

Definition at line 6687 of file qgis.h.

◆ operator>()

bool operator>	(	const QVariant &	v1,
		const QVariant &	v2
	)

inline

Compares two QVariant values and returns whether the first is greater than the second.

Useful for sorting lists of variants, correctly handling sorting of the various QVariant data types (such as strings, numeric values, dates and times)

See also: qgsVariantLessThan()

Definition at line 6673 of file qgis.h.

◆ qgsDoubleNear()

bool qgsDoubleNear	(	double	a,
		double	b,
		double	epsilon = `4 * std::numeric_limits<double>::epsilon()`
	)

inline

Compare two doubles (but allow some difference)

Parameters

a	first double
b	second double
epsilon	maximum difference allowable between doubles

Definition at line 6286 of file qgis.h.

◆ qgsDoubleNearSig()

bool qgsDoubleNearSig	(	double	a,
		double	b,
		int	significantDigits = `10`
	)

inline

Compare two doubles using specified number of significant digits.

Definition at line 6303 of file qgis.h.

◆ qgsDoubleToString()

QString qgsDoubleToString	(	double	a,
		int	precision = `17`
	)

inline

Returns a string representation of a double.

Parameters

a	double value
precision	number of decimal places to retain

Definition at line 6203 of file qgis.h.

◆ qgsEnumKeyToValue()

template<class T >

T qgsEnumKeyToValue	(	const QString &	key,
		const T &	defaultValue,
		bool	tryValueAsKey = `true`,
		bool *	returnOk = `nullptr`
	)

Returns the value corresponding to the given key of an enum.

If the key is invalid, it will return the defaultValue. If tryValueAsKey is true, it will try to convert the string key to an enum value If returnOk is given, it defines if the key could be converted to the value or if it had returned the default

Since: QGIS 3.6

Definition at line 6496 of file qgis.h.

◆ qgsEnumList()

template<class T >

const QList< T > qgsEnumList ( )

Returns a list all enum entries.

The enum must have been declared using Q_ENUM or Q_FLAG.

Definition at line 6443 of file qgis.h.

◆ qgsEnumMap()

template<class T >

const QMap< T, QString > qgsEnumMap ( )

Returns a map of all enum entries.

The map has the enum values (int) as keys and the enum keys (QString) as values. The enum must have been declared using Q_ENUM or Q_FLAG.

Definition at line 6460 of file qgis.h.

◆ qgsEnumValueToKey()

template<class T >

QString qgsEnumValueToKey	(	const T &	value,
		bool *	returnOk = `nullptr`
	)

Returns the value for the given key of an enum.

If returnOk is given, it defines if the value could be converted to the key

Since: QGIS 3.6

Definition at line 6477 of file qgis.h.

◆ qgsFlagKeysToValue()

template<class T >

T qgsFlagKeysToValue	(	const QString &	keys,
		const T &	defaultValue,
		bool	tryValueAsKey = `true`,
		bool *	returnOk = `nullptr`
	)

Returns the value corresponding to the given keys of a flag.

If the keys are invalid, it will return the defaultValue. If tryValueAsKey is true, it will try to convert the string key to an enum value. If returnOk is given, it defines if the key could be converted to the value or if it had returned the default

Since: QGIS 3.16

Definition at line 6557 of file qgis.h.

◆ qgsFlagValueToKeys()

template<class T >

QString qgsFlagValueToKeys	(	const T &	value,
		bool *	returnOk = `nullptr`
	)

Returns the value for the given keys of a flag.

If returnOk is given, it defines if the value could be converted to the keys

Since: QGIS 3.16

Definition at line 6535 of file qgis.h.

◆ qgsFloatNear()

bool qgsFloatNear	(	float	a,
		float	b,
		float	epsilon = `4 * FLT_EPSILON`
	)

inline

Compare two floats (but allow some difference)

Parameters

a	first float
b	second float
epsilon	maximum difference allowable between floats

Definition at line 6297 of file qgis.h.

◆ qgsFree()

void CORE_EXPORT qgsFree ( void * ptr )

Frees the memory space pointed to by ptr.

Works like C free().

Parameters

ptr	pointer to memory space

Definition at line 124 of file qgis.cpp.

◆ qgsMalloc()

void CORE_EXPORT * qgsMalloc ( size_t size )

Allocates size bytes and returns a pointer to the allocated memory.

Works like C malloc() but prints debug message by QgsLogger if allocation fails.

Parameters

size	size in bytes

Definition at line 102 of file qgis.cpp.

◆ qgsMapJoinKeys()

template<class Key , class Value >

QString qgsMapJoinKeys	(	const QMap< Key, Value > &	map,
		const QString &	separator
	)

Joins all the map keys into a single string with each element separated by the given separator.

This method avoid calling keys() before joining because it creates an unneeded temporary list see clazy container-anti-pattern

Definition at line 6343 of file qgis.h.

◆ qgsMapJoinValues()

template<class Key , class Value >

QString qgsMapJoinValues	(	const QMap< Key, Value > &	map,
		const QString &	separator
	)

Joins all the map values into a single string with each element separated by the given separator.

This method avoid calling values() before joining because it creates an unneeded temporary list see clazy container-anti-pattern

Definition at line 6360 of file qgis.h.

◆ qgsNanCompatibleEquals()

bool qgsNanCompatibleEquals	(	double	a,
		double	b
	)

inline

Compare two doubles, treating nan values as equal.

Parameters

a	first double
b	second double

Since: QGIS 3.20

Definition at line 6248 of file qgis.h.

◆ qgsNumberNear()

template<typename T >

bool qgsNumberNear	(	T	a,
		T	b,
		T	epsilon = `std::numeric_limits<T>::epsilon() * 4`
	)

inline

Compare two numbers of type T (but allow some difference)

Parameters

a	first number
b	second number
epsilon	maximum difference allowable between numbers

Since: QGIS 3.36

Definition at line 6268 of file qgis.h.

◆ qgsPermissiveToDouble()

CORE_EXPORT double qgsPermissiveToDouble	(	QString	string,
		bool &	ok
	)

Converts a string to a double in a permissive way, e.g., allowing for incorrect numbers of digits between thousand separators.

Parameters

string	string to convert
ok	will be set to `true` if conversion was successful

Returns: string converted to double if possible

See also: permissiveToInt

Definition at line 81 of file qgis.cpp.

◆ qgsPermissiveToInt()

CORE_EXPORT int qgsPermissiveToInt	(	QString	string,
		bool &	ok
	)

Converts a string to an integer in a permissive way, e.g., allowing for incorrect numbers of digits between thousand separators.

Parameters

string	string to convert
ok	will be set to `true` if conversion was successful

Returns: string converted to int if possible

See also: permissiveToDouble

Definition at line 88 of file qgis.cpp.

◆ qgsPermissiveToLongLong()

CORE_EXPORT qlonglong qgsPermissiveToLongLong	(	QString	string,
		bool &	ok
	)

Converts a string to an qlonglong in a permissive way, e.g., allowing for incorrect numbers of digits between thousand separators.

Parameters

string	string to convert
ok	will be set to `true` if conversion was successful

Returns: string converted to int if possible

See also: permissiveToInt

Since: QGIS 3.4

Definition at line 95 of file qgis.cpp.

◆ qgsRound()

double qgsRound	(	double	number,
		int	places
	)

inline

Returns a double number, rounded (as close as possible) to the specified number of places.

Definition at line 6327 of file qgis.h.

◆ qgsSetJoin()

template<class T >

QString qgsSetJoin	(	const QSet< T > &	set,
		const QString &	separator
	)

Joins all the set values into a single string with each element separated by the given separator.

This method avoid calling values() before joining because it creates an unneeded temporary list see clazy container-anti-pattern

Definition at line 6377 of file qgis.h.

◆ qgsVariantEqual()

CORE_EXPORT bool qgsVariantEqual	(	const QVariant &	lhs,
		const QVariant &	rhs
	)

Compares two QVariant values and returns whether they are equal, two NULL values are always treated as equal and 0 is not treated as equal with NULL.

Parameters

lhs	first value
rhs	second value

Returns: true if values are equal

Definition at line 256 of file qgis.cpp.

◆ qgsVariantGreaterThan()

CORE_EXPORT bool qgsVariantGreaterThan	(	const QVariant &	lhs,
		const QVariant &	rhs
	)

Compares two QVariant values and returns whether the first is greater than the second.

Useful for sorting lists of variants, correctly handling sorting of the various QVariant data types (such as strings, numeric values, dates and times)

See also: qgsVariantLessThan()

Definition at line 197 of file qgis.cpp.

◆ qgsVariantLessThan()

CORE_EXPORT bool qgsVariantLessThan	(	const QVariant &	lhs,
		const QVariant &	rhs
	)

Compares two QVariant values and returns whether the first is less than the second.

Useful for sorting lists of variants, correctly handling sorting of the various QVariant data types (such as strings, numeric values, dates and times)

Invalid < NULL < Values

See also: qgsVariantGreaterThan()

Definition at line 129 of file qgis.cpp.

◆ qgsVsiPrefix()

Q_DECL_DEPRECATED CORE_EXPORT QString qgsVsiPrefix ( const QString & path )

Returns a the vsi prefix which corresponds to a file path, or an empty string if the path is not associated with a vsi prefix.

Deprecated:: QGIS 3.44. Use QgsGdalUtils::vsiPrefixForPath() instead.

Definition at line 202 of file qgis.cpp.

◆ qHash()

CORE_EXPORT uint qHash ( const QVariant & variant )

Hash for QVariant.

Definition at line 207 of file qgis.cpp.

◆ whileBlocking()

template<class Object >

QgsSignalBlocker< Object > whileBlocking ( Object * object )

inline

Temporarily blocks signals from a QObject while calling a single method from the object.

Usage: whileBlocking( checkBox )->setChecked( true ); whileBlocking( spinBox )->setValue( 50 );

No signals will be emitted when calling these methods.

See also: QgsSignalBlocker

Note: not available in Python bindings

Definition at line 6190 of file qgis.h.

Variable Documentation

◆ GEO_EPSG_CRS_ID

Q_DECL_DEPRECATED const long GEO_EPSG_CRS_ID = 4326

Numeric ID for the EPSG:4326 geographic coordinate system.

Deprecated:: QGIS 3.44. Will be removed in QGIS 4.0.

Definition at line 6778 of file qgis.h.

◆ GEOCRS_ID

Q_DECL_DEPRECATED const long GEOCRS_ID = 3452

Numeric ID for the EPSG:4326 geographic coordinate system in QGIS internal srs database.

Deprecated:: QGIS 3.44. Will be removed in QGIS 4.0.

Definition at line 6771 of file qgis.h.

◆ GEOSRID

Q_DECL_DEPRECATED const long GEOSRID = 4326

Numeric ID for the EPSG:4326 geographic coordinate system.

Deprecated:: QGIS 3.44. Will be removed in QGIS 4.0.

Definition at line 6764 of file qgis.h.

Classes

Macros

Typedefs

Functions

Variables

Macro Definition Documentation

◆ BUILTIN_UNREACHABLE

◆ cast_to_fptr

◆ MAYBE_UNUSED

◆ NODISCARD

◆ Q_NOWARN_DEPRECATED_POP

◆ Q_NOWARN_DEPRECATED_PUSH

◆ Q_NOWARN_UNREACHABLE_POP

◆ Q_NOWARN_UNREACHABLE_PUSH

◆ QGISEXTERN

◆ QHASH_FOR_CLASS_ENUM

Typedef Documentation

◆ qgssize

◆ QgsStringMap

Function Documentation

◆ operator<()

◆ operator>()

◆ qgsDoubleNear()

◆ qgsDoubleNearSig()

◆ qgsDoubleToString()

◆ qgsEnumKeyToValue()

◆ qgsEnumList()

◆ qgsEnumMap()

◆ qgsEnumValueToKey()

◆ qgsFlagKeysToValue()

◆ qgsFlagValueToKeys()

◆ qgsFloatNear()

◆ qgsFree()

◆ qgsMalloc()

◆ qgsMapJoinKeys()

◆ qgsMapJoinValues()

◆ qgsNanCompatibleEquals()

◆ qgsNumberNear()

◆ qgsPermissiveToDouble()

◆ qgsPermissiveToInt()

◆ qgsPermissiveToLongLong()

◆ qgsRound()

◆ qgsSetJoin()

◆ qgsVariantEqual()

◆ qgsVariantGreaterThan()

◆ qgsVariantLessThan()

◆ qgsVsiPrefix()

◆ qHash()

◆ whileBlocking()

Variable Documentation

◆ GEO_EPSG_CRS_ID

◆ GEOCRS_ID

◆ GEOSRID