Search for usage in LXR

#include <KCountrySubdivision>


QString code
KCountry country
QString name
KCountrySubdivision parent
QList< KCountrySubdivisionsubdivisions
QStringList timeZoneIds

Public Member Functions

 KCountrySubdivision ()
 KCountrySubdivision (const KCountrySubdivision &)
QString code () const
KCountry country () const
bool isValid () const
QString name () const
bool operator!= (const KCountrySubdivision &other) const
KCountrySubdivisionoperator= (const KCountrySubdivision &)
bool operator== (const KCountrySubdivision &other) const
KCountrySubdivision parent () const
QList< KCountrySubdivisionsubdivisions () const
QList< const char * > timeZoneIds () const

Static Public Member Functions

static KCountrySubdivision fromCode (const char *code)
static KCountrySubdivision fromCode (QStringView code)
static KCountrySubdivision fromLocation (float latitude, float longitude)

Detailed Description

Information about an ISO 3166-2 country subdivision.

This requires the iso-codes data files and translation catalogs to be available at runtime.
See also
KCountry for the data sources.

Definition at line 27 of file kcountrysubdivision.h.

Property Documentation

◆ code

QString KCountrySubdivision::code

Definition at line 30 of file kcountrysubdivision.h.

◆ country

KCountry KCountrySubdivision::country

Definition at line 32 of file kcountrysubdivision.h.

◆ name

QString KCountrySubdivision::name

Definition at line 31 of file kcountrysubdivision.h.

◆ parent

KCountrySubdivision KCountrySubdivision::parent

Definition at line 33 of file kcountrysubdivision.h.

◆ subdivisions

QList<KCountrySubdivision> KCountrySubdivision::subdivisions

Definition at line 34 of file kcountrysubdivision.h.

◆ timeZoneIds

QStringList KCountrySubdivision::timeZoneIds

Definition at line 35 of file kcountrysubdivision.h.

Constructor & Destructor Documentation

◆ KCountrySubdivision()

KCountrySubdivision::KCountrySubdivision ( )

Creates an invalid/empty KCountrySubdivision instance.

See the fromX() methods for creating a valid instance.

Definition at line 20 of file kcountrysubdivision.cpp.

Member Function Documentation

◆ code()

QString KCountrySubdivision::code ( ) const

ISO 3166-2 country subdivision code.

Definition at line 44 of file kcountrysubdivision.cpp.

◆ country()

KCountry KCountrySubdivision::country ( ) const

Country this subdivision belongs to.

Definition at line 82 of file kcountrysubdivision.cpp.

◆ fromCode() [1/2]

KCountrySubdivision KCountrySubdivision::fromCode ( const char * code)

Create a KCountrySubdivision instance from an ISO 3166-2 code.

Definition at line 180 of file kcountrysubdivision.cpp.

◆ fromCode() [2/2]

KCountrySubdivision KCountrySubdivision::fromCode ( QStringView code)

Create a KCountrySubdivision instance from an ISO 3166-2 code.

Definition at line 173 of file kcountrysubdivision.cpp.

◆ fromLocation()

KCountrySubdivision KCountrySubdivision::fromLocation ( float latitude,
float longitude )

Looks up the country subdivision at the given geographic coordinate.

This can return an invalid object if the country subdivision could not be determined. This can happen in a number of cases:

  • on oceans
  • in polar regions
  • close to a land border
  • in disputed territories
    It is possible for KCountry::fromLocation() to return a valid result despite this method returning an invalid result.

Definition at line 189 of file kcountrysubdivision.cpp.

◆ isValid()

bool KCountrySubdivision::isValid ( ) const

Returns false if this is an empty/invalid/default constructed instance, true otherwise.

Definition at line 39 of file kcountrysubdivision.cpp.

◆ name()

QString KCountrySubdivision::name ( ) const

Translated country subdivision name.

Definition at line 67 of file kcountrysubdivision.cpp.

◆ operator!=()

bool KCountrySubdivision::operator!= ( const KCountrySubdivision & other) const

Definition at line 34 of file kcountrysubdivision.cpp.

◆ operator==()

bool KCountrySubdivision::operator== ( const KCountrySubdivision & other) const

Definition at line 29 of file kcountrysubdivision.cpp.

◆ parent()

KCountrySubdivision KCountrySubdivision::parent ( ) const

Parent subdivision, if this is a subdivision of another subdivision.

Returns an invalid element for top-level subdivisions.

Definition at line 89 of file kcountrysubdivision.cpp.

◆ subdivisions()

QList< KCountrySubdivision > KCountrySubdivision::subdivisions ( ) const

Subdivisions of this subdivision, if any.

This is only relevant for countries with multiple ISO 3166-2 subdivision levels.

Definition at line 131 of file kcountrysubdivision.cpp.

◆ timeZoneIds()

QList< const char * > KCountrySubdivision::timeZoneIds ( ) const

Timezones in use in this country subdivision.

Definition at line 107 of file kcountrysubdivision.cpp.

The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri May 17 2024 11:53:36 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.