qurl_p.h File Reference

(e4d0d0b7de436a0fe570963972a7c4795cb5404d)

#include <QtCore/private/qglobal_p.h>
#include "qurl.h"

Include dependency graph for qurl_p.h:

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

Go to the source code of this file.

Enumerations
enum	AceLeadingDot { AllowLeadingDot , ForbidLeadingDot }
enum	AceOperation { ToAceOnly , NormalizeAce }

Functions
Q_AUTOTEST_EXPORT qsizetype	qt_urlRecode (QString &appendTo, QStringView url, QUrl::ComponentFormattingOptions encoding, const ushort *tableModifications=nullptr)
qsizetype	qt_encodeFromUser (QString &appendTo, const QString &input, const ushort *tableModifications)
QString Q_CORE_EXPORT	qt_ACE_do (const QString &domain, AceOperation op, AceLeadingDot dot, QUrl::AceProcessingOptions options={})
Q_AUTOTEST_EXPORT void	qt_punycodeEncoder (QStringView in, QString *output)
Q_AUTOTEST_EXPORT QString	qt_punycodeDecoder (const QString &pc)

Variables
QT_BEGIN_NAMESPACE constexpr QUrl::ComponentFormattingOptions	QUrlDecodeForLocalFile

Enumeration Type Documentation

AceLeadingDot

enum AceLeadingDot

Enumerator
AllowLeadingDot
ForbidLeadingDot

Definition at line 38 of file qurl_p.h.

AceOperation

enum AceOperation

Enumerator
ToAceOnly
NormalizeAce

Definition at line 39 of file qurl_p.h.

Function Documentation

qt_ACE_do()

QString Q_CORE_EXPORT qt_ACE_do	(	const QString &	domain,
		AceOperation	op,
		AceLeadingDot	dot,
		QUrl::AceProcessingOptions	options = {} )

Definition at line 921 of file qurlidna.cpp.

qt_encodeFromUser()

qsizetype qt_encodeFromUser	(	QString &	appendTo,
		const QString &	input,
		const ushort *	tableModifications )

Definition at line 720 of file qurlrecode.cpp.

References defaultActionTable, and EncodeCharacter.

qt_punycodeDecoder()

Q_AUTOTEST_EXPORT QString qt_punycodeDecoder ( const QString & pc )

extern

Definition at line 172 of file qurlidna.cpp.

qt_punycodeEncoder()

Q_AUTOTEST_EXPORT void qt_punycodeEncoder ( QStringView in, QString * output )

extern

Definition at line 68 of file qurlidna.cpp.

References adapt(), appendEncode(), initial_bias, and initial_n.

Here is the call graph for this function:

qt_urlRecode()

Q_AUTOTEST_EXPORT qsizetype qt_urlRecode ( QString & appendTo, QStringView in, QUrl::ComponentFormattingOptions encoding, const ushort * tableModifications )

extern

Recodes the string from begin to end. If any transformations are done, append them to appendTo and return the number of characters added. If no transformations were required, return 0.

The encoding option modifies the default behaviour: \list

• QUrl::DecodeReserved: if set, reserved characters will be decoded; if unset, reserved characters will be encoded
• QUrl::EncodeSpaces: if set, spaces will be encoded to "%20"; if unset, they will be " "
• QUrl::EncodeUnicode: if set, characters above U+0080 will be encoded to their UTF-8 percent-encoded form; if unset, they will be decoded to UTF-16
• QUrl::FullyDecoded: if set, this function will decode all percent-encoded sequences, including that of the percent character. The resulting string will not be percent-encoded anymore. Use with caution! In this mode, the behaviour is undefined if the input string contains any percent-encoding sequences above %80. Also, the function will not correct bad % sequences.
• QUrlDecodeForLocalFile: if set, this performs the FullyDecoded mode with error checking suitable for local file paths. See decode() above for details. \endlist

Other flags are ignored (including QUrl::EncodeReserved).

The tableModifications argument can be used to supply extra modifications to the tables, to be applied after the flags above are handled. It consists of a sequence of 16-bit values, where the low 8 bits indicate the character in question and the high 8 bits are either EncodeCharacter, LeaveCharacter or DecodeCharacter.

This function corrects percent-encoded errors by interpreting every '' as meaning "%25" (all percents in the same content), except in Decoded modes.

On success, this function returns the number of characters added to appendTo, or -1 on error (errors are currently only detected if encoding is QUrlDecodeForLocalFile). A return value of 0 means this function had no percent-encoded transformations to perform, so the caller must append the in input to appendTo. This lets the caller return a shallow copy of the original QString (avoiding allocation) and keep control of its null-vs-empty state.

Definition at line 697 of file qurlrecode.cpp.

Variable Documentation

QUrlDecodeForLocalFile

QT_BEGIN_NAMESPACE constexpr QUrl::ComponentFormattingOptions QUrlDecodeForLocalFile

inlineconstexpr

Initial value:

                                                                 =
QUrl::FullyDecoded | QUrl::ComponentFormattingOption(0x8000000)

Definition at line 27 of file qurl_p.h.