QGeoAddress Class

Member Function Documentation

QGeoAddress::QGeoAddress()

Default constructor.

QGeoAddress::QGeoAddress(const QGeoAddress &other)

Constructs a copy of other.

[noexcept, since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)

Constructs a geo address object by moving from other.

This function was introduced in Qt 6.2.

[noexcept] QGeoAddress::~QGeoAddress()

Destroys this address.

QString QGeoAddress::city() const

Returns the city.

See also setCity().

void QGeoAddress::clear()

Clears all of the address' data fields.

QString QGeoAddress::country() const

Returns the country name.

See also setCountry().

QString QGeoAddress::countryCode() const

Returns the country code according to ISO 3166-1 alpha-3

See also setCountryCode().

QString QGeoAddress::county() const

Returns the county. The county is considered the second subdivision below country.

See also setCounty().

QString QGeoAddress::district() const

Returns the district. The district is considered the subdivison below city.

See also setDistrict().

bool QGeoAddress::isEmpty() const

Returns whether this address is empty. An address is considered empty if all of its fields are empty.

bool QGeoAddress::isTextGenerated() const

Returns true if QGeoAddress::text() is automatically generated from address elements, otherwise returns false if text() has been explicitly assigned.

See also text() and setText().

QString QGeoAddress::postalCode() const

Returns the postal code.

See also setPostalCode().

void QGeoAddress::setCity(const QString &city)

Sets the city.

See also city().

void QGeoAddress::setCountry(const QString &country)

Sets the country name.

See also country().

void QGeoAddress::setCountryCode(const QString &countryCode)

Sets the countryCode according to ISO 3166-1 alpha-3

See also countryCode().

void QGeoAddress::setCounty(const QString &county)

Sets the county.

See also county().

void QGeoAddress::setDistrict(const QString &district)

Sets the district.

See also district().

void QGeoAddress::setPostalCode(const QString &postalCode)

Sets the postalCode.

See also postalCode().

void QGeoAddress::setState(const QString &state)

Sets the state.

See also state().

void QGeoAddress::setStreet(const QString &street)

Sets the street name to street.

See also street() and setStreetNumber().

[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)

Sets the street number to streetNumber.

This may also contain things like a unit number, a building name, or anything else that might be used to distinguish one address from another.

This function was introduced in Qt 6.2.

See also streetNumber() and setStreet().

void QGeoAddress::setText(const QString &text)

If text is not empty, explicitly assigns text as the string to be returned by text(). isTextGenerated() will return false.

If text is empty, indicates that text() should be automatically generated from the address elements. isTextGenerated() will return true.

See also text().

QString QGeoAddress::state() const

Returns the state. The state is considered the first subdivision below country.

See also setState().

QString QGeoAddress::street() const

Returns the street name.

See also setStreet() and streetNumber().

[since 6.2] QString QGeoAddress::streetNumber() const

Returns the street number.

This may also contain things like a unit number, a building name, or anything else that might be used to distinguish one address from another.

This function was introduced in Qt 6.2.

See also setStreetNumber() and street().

[noexcept, since 6.2] void QGeoAddress::swap(QGeoAddress &other)

Swaps this address with other. This operation is very fast and never fails.

This function was introduced in Qt 6.2.

QString QGeoAddress::text() const

Returns the address as a single formatted string. It is the recommended string to use to display the address to the user. It typically takes the format of an address as found on an envelope, but this is not always necessarily the case.

The address text is either automatically generated or explicitly assigned. This can be determined by checking isTextGenerated.

If an empty string is provided to setText(), then isTextGenerated() will be set to true and text() will return a string which is locally formatted according to countryCode() and based on the elements of the address such as street, city and so on. Because the text string is generated from the address elements, a sequence of calls such as text(), setStreet(), text() may return different strings for each invocation of text().

If a non-empty string is provided to setText(), then isTextGenerated() will be set to false and text() will always return the explicitly assigned string. Calls to modify other elements such as setStreet(), setCity() and so on will not affect the resultant string from text().

See also setText().

[default, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)

Move-assigns the other to this address and returns a reference to this address.

This function was introduced in Qt 6.2.

QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)

Assigns the given address to this address and returns a reference to this address.