Qt 4.8: QString Class Reference

QBasicAtomicInt ref

Definition: qstring.h:604

QString::shared_null

static Data shared_null

Definition: qstring.h:616

Data * d

Definition: qstring.h:618

◆ QString() [2/12]

QString::QString	(	const QChar *	unicode,
		int	size
	)

Constructs a string initialized with the first size characters of the QChar array unicode.

QString makes a deep copy of the string data. The unicode data is copied as is and the Byte Order Mark is preserved if present.

Definition at line 1118 of file qstring.cpp.

 {
    if (!unicode) {
         d = &shared_null;
         d->ref.ref();
     } else if (size <= 0) {
         d = &shared_empty;
         d->ref.ref();
     } else {
         d = (Data*) qMalloc(sizeof(Data)+size*sizeof(QChar));
         Q_CHECK_PTR(d);
         d->ref = 1;
         d->alloc = d->size = size;
         d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
         d->data = d->array;
         memcpy(d->array, unicode, size * sizeof(QChar));
         d->array[size] = '\0';
     }
 }

◆ QString() [3/12]

QString::QString ( const QChar * unicode )

explicit

Constructs a string initialized with the characters of the QChar array unicode, which must be terminated with a 0.

Since: 4.7

QString makes a deep copy of the string data. The unicode data is copied as is and the Byte Order Mark is preserved if present.

Definition at line 1150 of file qstring.cpp.

 {
      if (!unicode) {
          d = &shared_null;
          d->ref.ref();
      } else {
          int size = 0;
          while (unicode[size] != 0)
              ++size;
          if (!size) {
              d = &shared_empty;
              d->ref.ref();
          } else {
              d = (Data*) qMalloc(sizeof(Data)+size*sizeof(QChar));
              Q_CHECK_PTR(d);
              d->ref = 1;
              d->alloc = d->size = size;
              d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
              d->data = d->array;
              memcpy(d->array, unicode, size * sizeof(QChar));
              d->array[size] = '\0';
          }
      }
 }

◆ QString() [4/12]

QString::QString ( QChar c )

Constructs a string of size 1 containing the character ch.

Definition at line 1236 of file qstring.cpp.

 {
     void *buf = qMalloc(sizeof(Data) + sizeof(QChar));
     Q_CHECK_PTR(buf);
     d = reinterpret_cast<Data *>(buf);
     d->ref = 1;
     d->alloc = d->size = 1;
     d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
     d->data = d->array;
     d->array[0] = ch.unicode();
     d->array[1] = '\0';
 }

◆ QString() [5/12]

QString::QString	(	int	size,
		QChar	ch
	)

Constructs a string of the given size with every character set to ch.

See also: fill()

Definition at line 1182 of file qstring.cpp.

 {
    if (size <= 0) {
         d = &shared_empty;
         d->ref.ref();
     } else {
         d = (Data*) qMalloc(sizeof(Data)+size*sizeof(QChar));
         Q_CHECK_PTR(d);
         d->ref = 1;
         d->alloc = d->size = size;
         d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
         d->data = d->array;
         d->array[size] = '\0';
         ushort *i = d->array + size;
         ushort *b = d->array;
         const ushort value = ch.unicode();
         while (i != b)
            *--i = value;
     }
 }

◆ QString() [6/12]

QString::QString ( const QLatin1String & str )

inline

Constructs a copy of the Latin-1 string str.

See also: fromLatin1()

Definition at line 694 of file qstring.h.

694 : d(fromLatin1_helper(aLatin1.latin1()))

695 { }

QString::fromLatin1_helper

Data * d

Definition: qstring.h:618

static Data * fromLatin1_helper(const char *str, int size=-1)

Definition: qstring.cpp:4104

◆ QString() [7/12]

QString::QString ( const QString & other )

inline

Constructs a copy of other.

This operation takes constant time, because QString is implicitly shared. This makes returning a QString from a function very fast. If a shared instance is modified, it will be copied (copy-on-write), and that takes linear time.

See also: operator=()

Definition at line 725 of file qstring.h.

725 : d(other.d)

726 { Q_ASSERT(&other != this); d->ref.ref(); }

QBasicAtomicInt::ref

bool ref()

Definition: qatomic_alpha.h:495

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

QBasicAtomicInt ref

Definition: qstring.h:604

Data * d

Definition: qstring.h:618

◆ ~QString()

QString::~QString ( )

inline

Destroys the string.

Definition at line 880 of file qstring.h.

880 { if (!d->ref.deref()) free(d); }

QBasicAtomicInt ref

Definition: qstring.h:604

QString::free

static void free(Data *)

Definition: qstring.cpp:1311

QString::fromAscii_helper

Data * d

Definition: qstring.h:618

QBasicAtomicInt::deref

bool deref()

Definition: qatomic_alpha.h:500

◆ QString() [8/12]

QString::QString ( const char * str )

inline

Constructs a string initialized with the 8-bit string str.

The given const char pointer is converted to Unicode using the fromAscii() function.

You can disable this constructor by defining QT_NO_CAST_FROM_ASCII when you compile your applications. This can be useful if you want to ensure that all user-visible strings go through QObject::tr(), for example.

See also: fromAscii(), fromLatin1(), fromLocal8Bit(), fromUtf8()

Definition at line 419 of file qstring.h.

419 : d(fromAscii_helper(ch))

420 {}

static Data * fromAscii_helper(const char *str, int size=-1)

Definition: qstring.cpp:4155

Data * d

Definition: qstring.h:618

◆ QString() [9/12]

QString::QString ( const QByteArray & ba )

inline

Constructs a string initialized with the byte array ba.

The given byte array is converted to Unicode using fromAscii(). Stops copying at the first 0 character, otherwise copies the entire byte array.

You can disable this constructor by defining QT_NO_CAST_FROM_ASCII when you compile your applications. This can be useful if you want to ensure that all user-visible strings go through QObject::tr(), for example.

See also: fromAscii(), fromLatin1(), fromLocal8Bit(), fromUtf8()

Definition at line 421 of file qstring.h.

422 : d(fromAscii_helper(a.constData(), qstrnlen(a.constData(), a.size())))

423 {}

QString::fromAscii_helper

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static Data * fromAscii_helper(const char *str, int size=-1)

Definition: qstring.cpp:4155

Data * d

Definition: qstring.h:618

uint qstrnlen(const char *str, uint maxlen)

Definition: qbytearray.h:82

◆ QString() [10/12]

QString::QString ( const Null & )

inline

Warning: This function is not part of the public interface.

Definition at line 503 of file qstring.h.

503 : d(&shared_null) { d->ref.ref(); }

QBasicAtomicInt::ref

bool ref()

Definition: qatomic_alpha.h:495

QBasicAtomicInt ref

Definition: qstring.h:604

QString::shared_null

static Data shared_null

Definition: qstring.h:616

Data * d

Definition: qstring.h:618

◆ QString() [11/12]

QString::QString	(	int	size,
		Qt::Initialization
	)

Constructs a string of the given size without initializing the characters.

Warning: This function is not part of the public interface.

This is only used in QStringBuilder::toString().

Definition at line 1212 of file qstring.cpp.

 {
     d = (Data*) qMalloc(sizeof(Data)+size*sizeof(QChar));
     Q_CHECK_PTR(d);
     d->ref = 1;
     d->alloc = d->size = size;
     d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
     d->data = d->array;
     d->array[size] = '\0';
 }

◆ QString() [12/12]

QString::QString	(	Data *	dd,
		int
	)

inlineprivate

Definition at line 619 of file qstring.h.

619 : d(dd) {}

Referenced by _q_escapeIdentifier(), QScriptDebuggerLocalsWidgetPrivate::_q_onCompletionTaskFinished(), QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QPrintPreviewDialogPrivate::_q_print(), QFileSystemEngine::absoluteName(), QZipWriter::addDirectory(), QScriptDebuggerLocalsModelPrivate::addTopLevelObject(), QByteArray::append(), QCoreApplication::applicationFilePath(), QPatternist::XQueryTokenizer::attributeAsRaw(), QAccessibleTextWidget::attributes(), QDeclarativeCompiler::buildDynamicMeta(), QScript::callQtMethod(), QPatternist::ColorOutput::colorify(), QPatternist::ColoringMessageHandler::colorifyDescription(), comify(), QMultiScreen::connect(), QScriptDebuggerConsole::consumeInput(), QWindowsLocalCodec::convertToUnicode(), QWindowsLocalCodec::convertToUnicodeCharByChar(), QScriptDebuggerConsolePrivate::createJob(), QAbstractFileEngineIterator::currentFilePath(), QScriptDebuggerLocalsModel::data(), QScriptBreakpointsModel::data(), QLocalePrivate::dateTimeToString(), decimalForm(), QSqlTableModel::deleteRowFromTable(), QSvgText::draw(), QRegExp::escape(), QPatternist::ColorOutputPrivate::escapeCode(), QDB2Driver::escapeIdentifier(), QIBaseDriver::escapeIdentifier(), QOCIDriver::escapeIdentifier(), QSQLite2Driver::escapeIdentifier(), QTDSDriver::escapeIdentifier(), QMYSQLDriver::escapeIdentifier(), QPSQLDriver::escapeIdentifier(), QODBCDriver::escapeIdentifier(), QPatternist::CodepointsToStringFN::evaluateSingleton(), exponentForm(), extractEncodingDecl(), QDeclarativeScriptParser::extractMetaData(), QFileSystemModelPrivate::filePath(), QTextBrowserPrivate::findFile(), fixedCharData(), fixedXmlName(), QTest::formatResult(), QTDSDriver::formatValue(), QMYSQLDriver::formatValue(), QScript::functionConnect(), QScript::functionPrint(), QBBSystemLocaleData::getCorrectFormat(), QSslSocketBackendPrivate::getErrorsFromOpenSsl(), QScriptCompleteScriptsJob::handleResponse(), QDeclarativeXMLHttpRequest::headers(), QScriptEngine::importExtension(), QScriptDebuggerLocalsModel::init(), init_platform(), initializeDb(), QTextDocumentPrivate::insert(), QTextDocumentPrivate::insertBlock(), isDirPath(), QSystemLibrary::load(), QFSFileEnginePrivate::longFileName(), QSharedMemoryPrivate::makePlatformSafeKey(), QScriptDebuggerConsoleWidget::message(), QScriptDebugOutputWidget::message(), QScriptErrorLogWidget::message(), QScriptStdMessageHandler::message(), QXlibMime::mimeAtomForFormat(), QFileSystemEngine::nativeAbsoluteFilePath(), QScriptEnginePrivate::newRegExp(), QPatternist::TokenRevealer::nextToken(), QPatternist::XQueryTokenizer::nextToken(), QFileSystemModelPrivate::node(), QPatternist::XQueryTokenizer::normalizeEOL(), QDBusXmlParser::objectTree(), QPSQLDriver::open(), QTemporaryFileEngine::open(), QSqlRelationalTableModel::orderByClause(), QSqlTableModel::orderByClause(), QDeclarativeStyledTextPrivate::parse(), QScriptXmlParser::parse(), parseCSStoXMLAttrs(), QPatternist::PatternPlatform::parseFlags(), QCss::Parser::parseFunction(), parseStopNode(), QTextHtmlParserNode::parseStyleAttribute(), QDeclarativeStyledTextPrivate::parseTag(), QSvgIconEnginePrivate::pmcKey(), QPSQLResult::prepare(), QApplicationPrivate::process_cmdline(), QTextStreamPrivate::putString(), qAppendWhereClause(), qCreateParamString(), QFileSystemIterator::QFileSystemIterator(), qGetTableInfo(), qIsEffectiveTLD(), qQuote(), QScriptDebuggerBackendPrivate::qsassert(), qt_readEscapedFormatString(), qws_dataDir(), qws_fontCacheDir(), readSourceFile(), QSqlRelationalTableModelPrivate::relationField(), QDeclarativeXMLHttpRequest::requestFromUrl(), QGLTextureGlyphCache::resizeTextureData(), QDeclarativeCompiledBindingsPrivate::run(), QSqlRelationalTableModel::selectStatement(), QSqlTableModel::selectStatement(), QPatternist::AbstractDuration::serializeMSeconds(), QPatternist::AbstractDateTime::serializeMSeconds(), QDeclarativeEngineDebugService::setMethodBody(), QUndoAction::setPrefixedText(), QGtkStylePrivate::setupGtkFileChooser(), QFileSystemEngine::slowCanonicalized(), QSettingsPrivate::splitArgs(), QFSCompleter::splitPath(), QSqlDriver::sqlStatement(), QPatternist::YearMonthDuration::stringValue(), QPatternist::Duration::stringValue(), QPatternist::DayTimeDuration::stringValue(), QConfFileSettingsPrivate::syncConfFile(), QPatternist::XsdInstanceReader::text(), QPatternist::XQueryTokenizer::tokenizeStringLiteral(), QProcessEnvironmentPrivate::toList(), QScriptContext::toString(), QHostAddress::toString(), QScriptDebuggerBackendPrivate::trace(), QSqlTableModel::updateRowInTable(), QSpinBoxValidator::validate(), vsprintf(), QXmlStreamWriterPrivate::write(), QXmlStreamWriterPrivate::writeEscaped(), QX11Data::xdndMimeAtomForFormat(), and QPatternist::AbstractDateTime::zoneOffsetToString().

Data * d

Definition: qstring.h:618

Functions

◆ append() [1/6]

QString & QString::append ( QChar c )

Definition at line 1777 of file qstring.cpp.

 {
     if (d->ref != 1 || d->size + 1 > d->alloc)
         realloc(grow(d->size + 1));
     d->data[d->size++] = ch.unicode();
     d->data[d->size] = '\0';
     return *this;
 }

◆ append() [2/6]

QString & QString::append ( const QString & str )

Appends the string str onto the end of this string.

Example:

    QString x = "free";
    QString y = "dom";
    x.append(y);
    // x == "freedom"

This is the same as using the insert() function:

x.insert(x.size(), y);

The append() function is typically very fast (constant time), because QString preallocates extra space at the end of the string data so it can grow without reallocating the entire string each time.

See also: operator+=(), prepend(), insert()

Definition at line 1701 of file qstring.cpp.

 {
     if (str.d != &shared_null) {
         if (d == &shared_null) {
             operator=(str);
         } else {
             if (d->ref != 1 || d->size + str.d->size > d->alloc)
                 realloc(grow(d->size + str.d->size));
             memcpy(d->data + d->size, str.d->data, str.d->size * sizeof(QChar));
             d->size += str.d->size;
             d->data[d->size] = '\0';
         }
     }
     return *this;
 }

◆ append() [3/6]

QString & QString::append ( const QStringRef & reference )

Appends the given string reference to this string and returns the result.

Since: 4.4

Definition at line 9017 of file qstring.cpp.

 {
     if (str.string() == this) {
         str.appendTo(this);
     } else if (str.string()) {
         int oldSize = size();
         resize(oldSize + str.size());
         memcpy(data() + oldSize, str.unicode(), str.size() * sizeof(QChar));
     }
     return *this;
 }

◆ append() [4/6]

QString & QString::append ( const QLatin1String & s )

Definition at line 1725 of file qstring.cpp.

 {
     const uchar *s = (const uchar *)str.latin1();
     if (s) {
         int len = qstrlen((char *)s);
         if (d->ref != 1 || d->size + len > d->alloc)
             realloc(grow(d->size + len));
         ushort *i = d->data + d->size;
         while ((*i++ = *s++))
             ;
         d->size += len;
     }
     return *this;
 }

◆ append() [5/6]

QT_ASCII_CAST_WARN QString& QString::append ( const char * s )

inline

Definition at line 436 of file qstring.h.

437 { return append(QString::fromAscii(s)); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ append() [6/6]

QT_ASCII_CAST_WARN QString& QString::append ( const QByteArray & s )

inline

Definition at line 438 of file qstring.h.

439 { return append(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

QString & append(QChar c)

Definition: qstring.cpp:1777

uint qstrnlen(const char *str, uint maxlen)

Definition: qbytearray.h:82

Referenced by QFileDialogPrivate::_q_goToDirectory(), QFtpPrivate::_q_piError(), QMessageBox::aboutQt(), QFileDialog::accept(), QDeclarativeImportsPrivate::add(), QGraphicsAnchorLayoutPrivate::addAnchor_helper(), QLocalServerPrivate::addListener(), RequestAnalyzer::analyze(), QDeclarativeXmlListModelPrivate::append_role(), QPSQLDriverPrivate::appendTables(), arg(), QSharedMemoryPrivate::attach(), QAccessibleTextWidget::attributes(), buildMatchRule(), QDeclarativeObjectMethodScriptClass::callPrecise(), QScript::callQtMethod(), QPatternist::XsdTypeChecker::checkConstrainingFacetsQName(), QUnixPrintWidgetPrivate::checkFields(), checkHRESULT(), QDBusPendingCallPrivate::checkReceivedSignature(), QCoreApplicationPrivate::checkReceiverThread(), QBenchmarkValgrindUtils::cleanup(), QGraphicsWidget::close(), QDeclarativeGestureAreaParser::compile(), QDeclarativeConnectionsParser::compile(), QVNCScreen::connect(), QMultiScreen::connect(), QTransformedScreen::connect(), QDeclarativeConnections::connectSignals(), QFile::copy(), QSharedMemory::create(), QSharedMemoryPrivate::create(), QPatternist::XsdSchemaParserContext::createAnonymousName(), createArrayBuffer(), createPixmapDataSync(), QDeclarativeAbstractAnimationPrivate::createProperty(), QLocale::createSeparatedList(), createSequence(), QOutputStrategy::createUniqueImageName(), QScriptDebuggerStackModel::data(), QScriptDebuggerScriptsModel::data(), QScriptBreakpointsModel::data(), QGraphicsSceneBspTree::debug(), QScriptDebuggerPrivate::debuggerEvent(), decodeMSG(), QScript::QObjectDelegate::deleteProperty(), derivedTermValid(), QPatternist::Expression::description(), QSharedMemoryPrivate::detach(), divZeroInvalid(), QWindowsXPStylePrivate::drawBackgroundThruNativeBuffer(), QMacStylePrivate::drawCombobox(), QWindowsVistaStyle::drawControl(), QGtkStyle::drawControl(), QWindowsVistaStyle::drawPrimitive(), QMacStylePrivate::drawTableHeader(), QGridLayoutRowInfo::dump(), QGraphicsAnchorLayoutPrivate::dumpGraph(), QSimplex::dumpMatrix(), dumpRecursive(), QPdfEnginePrivate::embedFont(), QKeySequencePrivate::encodeString(), QPatternist::ReplaceFN::errorAtEnd(), QHttpNetworkConnectionPrivate::errorDetail(), QWorkspace::eventFilter(), QPSQLResult::exec(), QScript::QMetaObjectWrapperObject::execute(), QDeclarativeImportedNamespace::find(), QDeclarativeImportsPrivate::find(), QDBusMetaObjectGenerator::findType(), QHttpThreadDelegate::finishedSlot(), QMinimalWindowSurface::flush(), fromScriptValue(), QNetworkAccessFtpBackend::ftpDone(), QScript::functionConnect(), QScript::functionDisconnect(), QSvgPaintEnginePrivate::generateGradientName(), generateInterfaceXml(), generateSubObjectXml(), QNativeWifiEngine::getInterfaceFromId(), QBenchmarkValgrindUtils::getNewestFileName(), QScript::QObjectDelegate::getOwnPropertyDescriptor(), QScript::QObjectDelegate::getOwnPropertySlot(), QFileIconProviderPrivate::getWinIcon(), QSystemSemaphorePrivate::handle(), QSharedMemoryPrivate::handle(), QDBusConnectionPrivate::handleObjectCall(), idivZeroInvalid(), QDeclarativeImportsPrivate::importExtension(), QDeclarativeImportDatabase::importPlugin(), QLocalSocketPrivate::init(), QPrintPreviewDialogPrivate::init(), init_platform(), QSharedMemoryPrivate::initKey(), QDeclarativeListModel::insert(), QDeclarativeDebugServer::instance(), QXmlSimpleReaderPrivate::isExpandedEntityValueTooLarge(), QLibraryPrivate::isPlugin(), QPatternist::CastingPlatform< UntypedAtomicConverter, true >::issueCastError(), QPatternist::XsdSchemaHelper::isValidAttributeUsesExtension(), QPatternist::XsdSchemaHelper::isValidAttributeUsesRestriction(), QPatternist::XsdTypeChecker::isValidString(), jump(), QPlatformIntegrationFactory::keys(), QLocalServer::listen(), QLibraryPrivate::load_sys(), QSystemTrayIconSys::locateSystemTray(), QSharedMemory::lock(), modZeroInvalid(), QTest::mouseEvent(), multiArg(), QPatternist::NCNameConstructor::nameIsXML(), QNetworkAccessCacheBackend::open(), QNetworkAccessFileBackend::open(), QAudioDeviceInfoInternal::open(), QOCIDriver::open(), QAudioInputPrivate::open(), QAudioOutputPrivate::open(), operator<<(), QBenchmarkValgrindUtils::outFileBase(), ParallelAnchorData::ParallelAnchorData(), QDateTimeParser::parse(), QScriptDebuggerAgent::positionChange(), QPSQLResult::prepare(), QHttpNetworkConnectionPrivate::prepareRequest(), QMYSQLDriver::primaryIndex(), QPSQLDriver::primaryIndex(), QDeclarativePixmapReader::processJob(), QDBusAbstractInterfacePrivate::property(), QDeclarativePropertyChangesPrivate::property(), QScript::QObjectDelegate::put(), qax_docuFromName(), QSvgPaintEngine::qbrushToSvg(), qDBusGenerateMetaObjectXml(), qDBusIntrospectObject(), qDBusReplyFill(), qExtractSecurityPolicyFromString(), qMakeError(), QNetworkReplyDataImpl::QNetworkReplyDataImpl(), QNetworkReplyFileImpl::QNetworkReplyFileImpl(), QScript::qobjectProtoFuncToString(), QScriptDebuggerBackendPrivate::qsassert(), qt_eval_string(), QApplicationPrivate::qt_mac_apply_settings(), qt_mac_menu_merge_text(), qt_parse_pattern(), qt_parsePrinterDesc(), qt_parsePrintersConf(), qTdsErrHandler(), qTdsMsgHandler(), QDeclarativeXmlListModel::queryError(), rasterFallbackWarn(), QAudioInputPrivate::read(), MetaObjectGenerator::readClassInfo(), readImage(), QNetworkAccessFileBackend::readMoreFromFile(), QOCIDriver::record(), QTDSDriver::record(), QPSQLDriver::record(), QDeclarativeListModel::remove(), replacePercentN(), QGraphicsAnchorLayoutPrivate::replaceVertex(), QSslSocketPrivate::resetDefaultCiphers(), QLibraryPrivate::resolve_sys(), QDeclarativeCompiledBindingsPrivate::run(), QSvgPaintEngine::saveGradientStops(), QScript::Lexer::scanRegExp(), QDeclarativeJS::Lexer::scanRegExp(), QPatternist::XsdValidatingInstanceReader::selectNodeSets(), QSqlRelationalTableModel::selectStatement(), QDBusConnectionPrivate::sendError(), SequentialAnchorData::SequentialAnchorData(), Graph< AnchorVertex, AnchorData >::serializeToDot(), QDeclarativeListModel::set(), QLocalServerPrivate::setError(), QStateMachinePrivate::setError(), QSocks5SocketEnginePrivate::setErrorState(), QSystemSemaphorePrivate::setErrorString(), QLocalSocketPrivate::setErrorString(), QSharedMemoryPrivate::setErrorString(), QMdiSubWindowPrivate::setNewWindowTitle(), QUndoAction::setPrefixedText(), QDeclarativeListModel::setProperty(), AVMediaObject::setSource(), QDirModelPrivate::size(), QFileSystemModelPrivate::size(), standardLibraryErrorString(), QXmlStreamReaderPrivate::startDocument(), QSvgHandler::startElement(), QScript::stringProtoFuncArg(), QHttpThreadDelegate::synchronousFinishedSlot(), QSQLiteDriver::tables(), QAudioDeviceInfoInternal::testSettings(), QAccessibleItemRow::text(), QLocale::toCurrencyString(), QTextHtmlExporter::toHtml(), QBenchmarkContext::toString(), AnchorVertex::toString(), QDate::toString(), QSimplexConstraint::toString(), QHttpResponseHeader::toString(), AnchorData::toString(), QHttpRequestHeader::toString(), QTime::toString(), GraphPath::toString(), translate_color(), translate_dashPattern(), QSharedMemoryPrivate::tryLocker(), QPatternist::XSLTTokenizer::unexpectedContent(), QLibraryPrivate::unload_sys(), QSharedMemory::unlock(), QDeclarativeBinding::update(), QFactoryLoader::updateDir(), QNetworkAccessFileBackend::uploadReadyReadSlot(), QPatternist::XsdValidatingInstanceReader::validate(), QPatternist::MaintainingReader< XSLTTokenLookup >::validateElement(), QScript::variantProtoFuncToString(), vsprintf(), QIBaseResultPrivate::writeArray(), QTextOdfWriter::writeCharacterFormat(), QTextOdfWriter::writeListFormat(), QPatternist::CardinalityVerifier::wrongCardinality(), QPatternist::TypeChecker::wrongType(), and QApplicationPrivate::x11_apply_settings().

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ arg() [1/20]

QString QString::arg	(	qlonglong	a,
		int	fieldwidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

Definition at line 7186 of file qstring.cpp.

 {
     ArgEscapeData d = findArgEscapes(*this);
 
     if (d.occurrences == 0) {
         qWarning() << "QString::arg: Argument missing:" << *this << ',' << a;
         return *this;
     }
 
     unsigned flags = QLocalePrivate::NoFlags;
     if (fillChar == QLatin1Char('0'))
         flags = QLocalePrivate::ZeroPadded;
 
     QString arg;
     if (d.occurrences > d.locale_occurrences)
         arg = QLocale::c().d()->longLongToString(a, -1, base, fieldWidth, flags);
 
     QString locale_arg;
     if (d.locale_occurrences > 0) {
         QLocale locale;
         if (!locale.numberOptions() & QLocale::OmitGroupSeparator)
             flags |= QLocalePrivate::ThousandsGroup;
         locale_arg = locale.d()->longLongToString(a, -1, base, fieldWidth, flags);
     }
 
     return replaceArgEscapes(*this, d, fieldWidth, arg, locale_arg, fillChar);
 }

◆ arg() [2/20]

QString QString::arg	(	qulonglong	a,
		int	fieldwidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

Definition at line 7233 of file qstring.cpp.

 {
     ArgEscapeData d = findArgEscapes(*this);
 
     if (d.occurrences == 0) {
         qWarning() << "QString::arg: Argument missing:" << *this << ',' << a;
         return *this;
     }
 
     unsigned flags = QLocalePrivate::NoFlags;
     if (fillChar == QLatin1Char('0'))
         flags = QLocalePrivate::ZeroPadded;
 
     QString arg;
     if (d.occurrences > d.locale_occurrences)
         arg = QLocale::c().d()->unsLongLongToString(a, -1, base, fieldWidth, flags);
 
     QString locale_arg;
     if (d.locale_occurrences > 0) {
         QLocale locale;
         if (!locale.numberOptions() & QLocale::OmitGroupSeparator)
             flags |= QLocalePrivate::ThousandsGroup;
         locale_arg = locale.d()->unsLongLongToString(a, -1, base, fieldWidth, flags);
     }
 
     return replaceArgEscapes(*this, d, fieldWidth, arg, locale_arg, fillChar);
 }

◆ arg() [3/20]

QString QString::arg	(	long	a,
		int	fieldwidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

inline

Definition at line 747 of file qstring.h.

748 { return arg(qlonglong(a), fieldWidth, base, fillChar); }

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static const uint base

Definition: qurl.cpp:268

QString arg(qlonglong a, int fieldwidth=0, int base=10, const QChar &fillChar=QLatin1Char(' ')) const Q_REQUIRED_RESULT

Definition: qstring.cpp:7186

qint64 qlonglong

Definition: qglobal.h:951

◆ arg() [4/20]

QString QString::arg	(	ulong	a,
		int	fieldwidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

inline

Definition at line 749 of file qstring.h.

750 { return arg(qulonglong(a), fieldWidth, base, fillChar); }

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static const uint base

Definition: qurl.cpp:268

QString arg(qlonglong a, int fieldwidth=0, int base=10, const QChar &fillChar=QLatin1Char(' ')) const Q_REQUIRED_RESULT

Definition: qstring.cpp:7186

quint64 qulonglong

Definition: qglobal.h:952

◆ arg() [5/20]

QString QString::arg	(	int	a,
		int	fieldWidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

inline

Definition at line 743 of file qstring.h.

744 { return arg(qlonglong(a), fieldWidth, base, fillChar); }

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static const uint base

Definition: qurl.cpp:268

QString arg(qlonglong a, int fieldwidth=0, int base=10, const QChar &fillChar=QLatin1Char(' ')) const Q_REQUIRED_RESULT

Definition: qstring.cpp:7186

qint64 qlonglong

Definition: qglobal.h:951

◆ arg() [6/20]

QString QString::arg	(	uint	a,
		int	fieldWidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

inline

Definition at line 745 of file qstring.h.

746 { return arg(qulonglong(a), fieldWidth, base, fillChar); }

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static const uint base

Definition: qurl.cpp:268

QString arg(qlonglong a, int fieldwidth=0, int base=10, const QChar &fillChar=QLatin1Char(' ')) const Q_REQUIRED_RESULT

Definition: qstring.cpp:7186

quint64 qulonglong

Definition: qglobal.h:952

◆ arg() [7/20]

QString QString::arg	(	short	a,
		int	fieldWidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

inline

fieldWidth specifies the minimum amount of space that a is padded to and filled with the character fillChar.

A positive value produces right-aligned text; a negative value produces left-aligned text.

The base must be between 2 and 36, with 8 giving octal, 10 decimal, and 16 hexadecimal numbers.

If fillChar is '0' (the number 0, ASCII 48), the locale's zero is used. For negative numbers, zero padding might appear before the minus sign.

Definition at line 751 of file qstring.h.

752 { return arg(qlonglong(a), fieldWidth, base, fillChar); }

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static const uint base

Definition: qurl.cpp:268

QString arg(qlonglong a, int fieldwidth=0, int base=10, const QChar &fillChar=QLatin1Char(' ')) const Q_REQUIRED_RESULT

Definition: qstring.cpp:7186

qint64 qlonglong

Definition: qglobal.h:951

◆ arg() [8/20]

QString QString::arg	(	ushort	a,
		int	fieldWidth = `0`,
		int	base = `10`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

inline

Definition at line 753 of file qstring.h.

754 { return arg(qulonglong(a), fieldWidth, base, fillChar); }

long ASN1_INTEGER_get ASN1_INTEGER * a

Definition: qsslsocket_openssl_symbols.cpp:104

static const uint base

Definition: qurl.cpp:268

QString arg(qlonglong a, int fieldwidth=0, int base=10, const QChar &fillChar=QLatin1Char(' ')) const Q_REQUIRED_RESULT

Definition: qstring.cpp:7186

quint64 qulonglong

Definition: qglobal.h:952

◆ arg() [9/20]

QString QString::arg	(	double	a,
		int	fieldWidth = `0`,
		char	fmt = `'g'`,
		int	prec = `-1`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

Definition at line 7357 of file qstring.cpp.

 {
     ArgEscapeData d = findArgEscapes(*this);
 
     if (d.occurrences == 0) {
         qWarning("QString::arg: Argument missing: %s, %g", toLocal8Bit().data(), a);
         return *this;
     }
 
     unsigned flags = QLocalePrivate::NoFlags;
     if (fillChar == QLatin1Char('0'))
         flags = QLocalePrivate::ZeroPadded;
 
     if (qIsUpper(fmt))
         flags |= QLocalePrivate::CapitalEorX;
     fmt = qToLower(fmt);
 
     QLocalePrivate::DoubleForm form = QLocalePrivate::DFDecimal;
     switch (fmt) {
     case 'f':
         form = QLocalePrivate::DFDecimal;
         break;
     case 'e':
         form = QLocalePrivate::DFExponent;
         break;
     case 'g':
         form = QLocalePrivate::DFSignificantDigits;
         break;
     default:
 #if defined(QT_CHECK_RANGE)
         qWarning("QString::arg: Invalid format char '%c'", fmt);
 #endif
         break;
     }
 
     QString arg;
     if (d.occurrences > d.locale_occurrences)
         arg = QLocale::c().d()->doubleToString(a, prec, form, fieldWidth, flags);
 
     QString locale_arg;
     if (d.locale_occurrences > 0) {
         QLocale locale;
 
         if (!locale.numberOptions() & QLocale::OmitGroupSeparator)
             flags |= QLocalePrivate::ThousandsGroup;
         locale_arg = locale.d()->doubleToString(a, prec, form, fieldWidth, flags);
     }
 
     return replaceArgEscapes(*this, d, fieldWidth, arg, locale_arg, fillChar);
 }

◆ arg() [10/20]

QString QString::arg	(	char	a,
		int	fieldWidth = `0`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

Definition at line 7322 of file qstring.cpp.

 {
     QString c;
     c += QLatin1Char(a);
     return arg(c, fieldWidth, fillChar);
 }

◆ arg() [11/20]

QString QString::arg	(	QChar	a,
		int	fieldWidth = `0`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

Definition at line 7307 of file qstring.cpp.

 {
     QString c;
     c += a;
     return arg(c, fieldWidth, fillChar);
 }

◆ arg() [12/20]

QString QString::arg	(	const QString &	a,
		int	fieldWidth = `0`,
		const QChar &	fillChar = `QLatin1Char(' ')`
	)		const

Returns a copy of this string with the lowest numbered place marker replaced by string a, i.e., %1, %2, ..., %99.

fieldWidth specifies the minimum amount of space that argument a shall occupy. If a requires less space than fieldWidth, it is padded to fieldWidth with character fillChar. A positive fieldWidth produces right-aligned text. A negative fieldWidth produces left-aligned text.

This example shows how we might create a status string for reporting progress while processing a list of files:

    QString i;           // current file's number
    QString total;       // number of files to process
    QString fileName;    // current file's name
    QString status = QString("Processing file %1 of %2: %3")
                    .arg(i).arg(total).arg(fileName);

First, arg(i) replaces %1. Then arg(total) replaces %2. Finally, arg(fileName) replaces %3.

One advantage of using arg() over sprintf() is that the order of the numbered place markers can change, if the application's strings are translated into other languages, but each arg() will still replace the lowest numbered unreplaced place marker, no matter where it appears. Also, if place marker i appears more than once in the string, the arg() replaces all of them.

If there is no unreplaced place marker remaining, a warning message is output and the result is undefined. Place marker numbers must be in the range 1 to 99.

Definition at line 6962 of file qstring.cpp.

 {
     ArgEscapeData d = findArgEscapes(*this);
 
     if (d.occurrences == 0) {
         qWarning("QString::arg: Argument missing: %s, %s", toLocal8Bit().data(),
                   a.toLocal8Bit().data());
         return *this;
     }
     return replaceArgEscapes(*this, d, fieldWidth, a, a, fillChar);
 }

◆ arg() [13/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2
	)		const

inline

Definition at line 755 of file qstring.h.

756 { const QString *args[2] = { &a1, &a2 }; return multiArg(2, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [14/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3
	)		const

inline

Definition at line 757 of file qstring.h.

758 { const QString *args[3] = { &a1, &a2, &a3 }; return multiArg(3, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [15/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3,
		const QString &	a4
	)		const

inline

Definition at line 759 of file qstring.h.

761 { const QString *args[4] = { &a1, &a2, &a3, &a4 }; return multiArg(4, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [16/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3,
		const QString &	a4,
		const QString &	a5
	)		const

inline

Definition at line 762 of file qstring.h.

764 { const QString *args[5] = { &a1, &a2, &a3, &a4, &a5 }; return multiArg(5, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [17/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3,
		const QString &	a4,
		const QString &	a5,
		const QString &	a6
	)		const

inline

Definition at line 765 of file qstring.h.

767 { const QString *args[6] = { &a1, &a2, &a3, &a4, &a5, &a6 }; return multiArg(6, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [18/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3,
		const QString &	a4,
		const QString &	a5,
		const QString &	a6,
		const QString &	a7
	)		const

inline

Definition at line 768 of file qstring.h.

771 { const QString *args[7] = { &a1, &a2, &a3, &a4, &a5, &a6, &a7 }; return multiArg(7, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [19/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3,
		const QString &	a4,
		const QString &	a5,
		const QString &	a6,
		const QString &	a7,
		const QString &	a8
	)		const

inline

Definition at line 772 of file qstring.h.

775 { const QString *args[8] = { &a1, &a2, &a3, &a4, &a5, &a6, &a7, &a8 }; return multiArg(8, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ arg() [20/20]

QString QString::arg	(	const QString &	a1,
		const QString &	a2,
		const QString &	a3,
		const QString &	a4,
		const QString &	a5,
		const QString &	a6,
		const QString &	a7,
		const QString &	a8,
		const QString &	a9
	)		const

inline

Definition at line 776 of file qstring.h.

779 { const QString *args[9] = { &a1, &a2, &a3, &a4, &a5, &a6, &a7, &a8, &a9 }; return multiArg(9, args); }

The QString class provides a Unicode character string.

Definition: qstring.h:83

Referenced by QFileSystemModelPrivate::_q_fileSystemChanged(), _q_parseUnixDir(), QAbstractSocketPrivate::_q_startConnecting(), QDeclarativeTypeLoader::absoluteFilePath(), QNSOpenSavePanelDelegate::acceptableExtensionsForSave, QSvgIconEngine::addFile(), QPixmapIconEngine::addFile(), QDir::addResourceSearchPath(), QPatternist::XQueryTokenizer::aheadEquals(), QTextHtmlImporter::appendNodeText(), QCoreApplication::applicationFilePath(), QTextHtmlParser::applyAttributes(), QUnixPrintWidgetPrivate::applyPrinterProperties(), QKeySequence::assign(), QStringRef::at(), QTextEngine::atSpace(), QPatternist::DerivedString< TypeToken >::attributeNormalize(), QTextEngine::atWordSeparator(), QLineControl::backspace(), QFileSystemEntry::baseName(), QDeclarativeCompiler::buildDynamicMeta(), canonicalOrderHelper(), QDeclarativeCompiler::checkDynamicMeta(), QDeclarativeCompiler::checkValidId(), QDirModelPrivate::children(), QDir::cleanPath(), QLocalePrivate::codeToScript(), comify(), QDeclarativeConnectionsParser::compile(), QFileSystemEntry::completeBaseName(), QScriptCompletionTaskPrivate::completeScriptExpression(), composeHelper(), QVFbScreen::connect(), QScriptEnginePrivate::convertValue(), QCalendarDateValidator::countRepeat(), countRepeat(), QPatternist::XQueryTokenizer::current(), QPSQLResult::data(), QLocalePrivate::dateTimeToString(), QPatternist::CompressedWhitespace::decompress(), QTextCursor::deletePreviousChar(), QStyledItemDelegate::displayText(), driveSpec(), QAxBase::dynamicCallHelper(), QTextEngine::elidedText(), QTextHtmlExporter::emitBlock(), encodeText(), Qt::escape(), QRegExp::escape(), QPatternist::escape(), QScriptDebuggerCodeView::event(), extractEncodingDecl(), QDeclarativeScriptParser::extractMetaData(), QXmlStreamReaderPrivate::fastScanContentCharList(), QFileSystemEntry::fileName(), QFileSystemEngine::fillMetaData(), QDeclarativeImportedNamespace::find(), QDateTimeParser::findAmPm(), QDateTimeParser::findDay(), findGraphicsFactory(), findGroupFactory(), findInBlock(), QDateTimeParser::findMonth(), findObject(), findStyleFactoryMethod(), findStyleUtilFactoryMethod(), findUtilFactory(), fixedCharData(), fixedXmlName(), fmtDateTime(), QTest::formatResult(), QSqlDriver::formatValue(), QChar::fromAscii(), QPatternist::NamePool::fromClarkName(), fromHex(), QUrl::fromLocalFile(), QDateTime::fromString(), QXmlStreamReaderPrivate::getChar(), QXmlStreamReaderPrivate::getChar_helper(), getFmtString(), QSystemLocalePrivate::getLocaleInfo_qchar(), getMessage(), getNextChar(), QMacInputContext::globalEventProcessor(), QLineControl::hasAcceptableInput(), QTextHtmlParserNode::hasOnlyWhitespace(), QTextHtmlParser::hasPrefix(), hasUnquotedAP(), hasValidSignal(), QScriptSyntaxHighlighter::highlightBlock(), QScriptSyntaxHighlighter::highlightWord(), QDirModel::index(), iniChopTrailingSpaces(), QSettingsPrivate::iniEscapedKey(), QSettingsPrivate::iniEscapedString(), QDeclarativePropertyPrivate::initProperty(), QTextDocumentPrivate::insert_block(), QTextDocumentPrivate::insert_string(), QTextCursor::insertText(), QPatternist::XSLTTokenizer::insideTemplate(), QLineControl::internalDelete(), QLineControl::internalInsert(), QFileSystemEntry::isAbsolute(), isDirPath(), QFileSystemEntry::isDriveRoot(), QPatternist::LangFN::isLangMatch(), isLineSeparatorBlockAfterTable(), QUrl::isParentOf(), QXmlUtils::isPublicID(), QDateTimeEditPrivate::isSeparatorKey(), isSignalPropertyName(), isSupportedSvgFeature(), QPatternist::DerivedString< TypeToken >::isValidName(), QPatternist::DerivedString< TypeToken >::isValidNMTOKEN(), QTest::keyClicks(), QTextControlPrivate::keyPressEvent(), QMenu::keyPressEvent(), QTextEdit::keyPressEvent(), QStringRef::lastIndexOf(), QPatternist::ProcessingInstructionConstructor::leftTrimmed(), QCoreApplication::libraryPaths(), QTranslator::load(), longestCommonPrefix(), QFSFileEnginePrivate::longFileName(), macToQtFormat(), mapToLowerCase(), Qt::mightBeRichText(), QKeySequence::mnemonic(), QTextDocumentPrivate::move(), QTextCursorPrivate::movePosition(), QDeclarativeProperty::name(), QFileSystemEngine::nativeAbsoluteFilePath(), QTextHtmlParser::newNode(), QCssScanner_Generated::next(), QPatternist::ToCodepointsIterator::next(), QTextLineItemIterator::next(), QPatternist::XQueryTokenizer::nextToken(), QFileSystemModelPrivate::node(), QSettingsPrivate::normalizedKey(), QPatternist::XQueryTokenizer::normalizeEOL(), QTextFrame::iterator::operator++(), QTextFrame::iterator::operator--(), operator<<(), QDeclarativeDirParser::parse(), QHttpHeader::parse(), QXmlStreamReaderPrivate::parse(), parseCombinedArgString(), QSvgHandler::parseCSStoXMLAttrs(), QTextHtmlParser::parseEntity(), QPatternist::PatternPlatform::parseFlags(), QDateTimeParser::parseFormat(), QLineControl::parseInputMask(), QDeclarativeBindingCompilerPrivate::parseName(), QDateTimeParser::parseSection(), QFileSystemEntry::path(), QPatternist::XQueryTokenizer::peekAhead(), QXmlStreamReaderPrivate::peekChar(), QPatternist::XQueryTokenizer::peekForColonColon(), QKeyMapper::possibleKeys(), QSqlResult::prepare(), QCss::Scanner::preprocess(), QLineControl::processKeyEvent(), QFtpPI::processReply(), QTextHtmlImporter::processSpecialNodes(), QXmlStreamReaderPrivate::putReplacement(), QXmlStreamReaderPrivate::putReplacementInAttributeValue(), QTextStreamPrivate::putString(), QXmlStreamReaderPrivate::putString(), QXmlStreamReaderPrivate::putStringLiteral(), QChar::QChar(), qDBusGenerateMetaObjectXml(), qDBusInterfaceFromMetaObject(), QDeclarative_isFileCaseCorrect(), QDeclarativeImportDatabase::QDeclarativeImportDatabase(), QScript::qobjectProtoFuncFindChild(), qReplacePlaceholderMarkers(), qt_accAmpIndex(), qt_accHotKey(), qt_create_commandline(), qt_format_text(), qt_mac_removeMnemonics(), qt_readEscapedFormatString(), qt_repeatCount(), qt_set_x11_resources(), qt_splitLocaleName(), qt_string_normalize(), qt_strippedText(), readSymLink(), QPSQLDriver::record(), QFactoryLoader::refreshAll(), QTextDocumentPrivate::remove_block(), QTextDocumentPrivate::remove_string(), QCoreApplication::removeLibraryPath(), QLineControl::removeSelectedText(), QItemDelegatePrivate::replaceNewLine(), replacePercentN(), QDirModelPrivate::restorePersistentIndexes(), rotateSlashesDotsAndMiddots(), QTextDocumentPrivate::scan_frames(), QDeclarativeViewSection::sectionString(), QFileDialog::selectFile(), QLineEdit::selectionStart(), QCoreApplication::setApplicationVersion(), QUrlPrivate::setAuthority(), QCalendarDateValidator::setFormat(), QDirPrivate::setPath(), QGtkStylePrivate::setupGtkFileChooser(), QFileSystemEngine::slowCanonicalized(), QSettingsPrivate::splitArgs(), QProcessPrivate::startProcess(), stringContainsNullChar(), QSettingsPrivate::stringListToVariantList(), QScript::stringProtoFuncArg(), QPatternist::AbstractFloat< isDouble >::stringValue(), timeFormatContainsAP(), QPatternist::Tokenizer::tokenToString(), QUrl::toLocalFile(), QUrl::toString(), totalDigitsForDecimal(), QFontEngineXLFD::toUnicode(), translateKeyEventInternal(), tryDriveUNCFallback(), typeNameToXml(), QTextDocumentPrivate::unite(), unquote(), QDeclarativeListViewPrivate::updateCurrentSection(), QLineControl::updateDisplayText(), QKeyMapperPrivate::updateKeyMap(), QLocalePrivate::updateSystemPrivate(), QDateTimeEditPrivate::validateAndInterpret(), QLocalePrivate::validateChars(), QSystemLocalePrivate::winToQtFormat(), QXmlSerializer::writeEscaped(), QXmlStreamWriterPrivate::writeEscaped(), QXmlSerializer::writeEscapedAttribute(), and xpmHash().

QString multiArg(int numArgs, const QString **args) const

Definition: qstring.cpp:7434

◆ at()

const QChar QString::at ( int position ) const

inline

Returns the character at the given index position in the string.

The position must be a valid index position in the string (i.e., 0 <= position < size()).

See also: operator[]()

Definition at line 698 of file qstring.h.

699 { Q_ASSERT(uint(i) < uint(size())); return d->data[i]; }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

QString::size

int size() const

Returns the number of characters in this string.

Definition: qstring.h:102

uint

unsigned int uint

Definition: qglobal.h:996

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ begin() [1/2]

QString::iterator QString::begin ( )

inline

Returns an STL-style iterator pointing to the first character in the string.

See also: constBegin(), end()

Definition at line 888 of file qstring.h.

Referenced by containsProhibitedOuptut().

889 { detach(); return reinterpret_cast<QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

QString::detach

void detach()

Definition: qstring.h:714

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ begin() [2/2]

QString::const_iterator QString::begin ( ) const

inline

Definition at line 890 of file qstring.h.

891 { return reinterpret_cast<const QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ capacity()

int QString::capacity ( ) const

inline

Returns the maximum number of characters that can be stored in the string without forcing a reallocation.

The sole purpose of this function is to provide a means of fine tuning QString's memory usage. In general, you will rarely ever need to call this function. If you want to know how many characters are in the string, call size().

See also: reserve(), squeeze()

Definition at line 727 of file qstring.h.

Referenced by QOCIResultPrivate::bindValue(), QTextDocumentPrivate::compressPieceTable(), QODBCResult::exec(), and qt_ACE_do().

728 { return d->alloc; }

QString::Data::alloc

int alloc

Definition: qstring.h:605

Referenced by QDeclarativeImportsPrivate::add(), QWindowsFileSystemWatcherEngine::addPaths(), argToString(), buildMatchRule(), QDirModelPrivate::children(), QDir::cleanPath(), QFileSystemEngine::createDirectory(), QPSQLResult::data(), elliditide(), QTextHtmlExporter::emitCharFormatStyle(), QTextHtmlExporter::emitFragment(), QTextHtmlExporter::emitFrameStyle(), QTest::formatResult(), QDateTime::fromString(), getFindData(), QFileSystemEngine::getLinkTarget(), QSQLite2ResultPrivate::init(), intValueHelper(), isDirPath(), jump(), QCss::ValueExtractor::lengthValue(), QCompletionEngine::matchHint(), QDirModelPrivate::name(), QPatternist::TokenRevealer::nextToken(), QFileSystemModelPrivate::node(), QXmlStreamReaderPrivate::parse(), parseAnimateColorNode(), parseAnimateTransformNode(), QCss::Parser::parseFunction(), parseIp6(), parseLength(), QCss::Parser::parseTerm(), QTextDocumentPrivate::plainText(), qt_parsePrintcap(), qt_parseQconfig(), QWizardField::QWizardField(), QFtpPI::readyRead(), QCss::Declaration::realValue(), removeOptionalQuotes(), QWindowsFileSystemWatcherEngine::removePaths(), QDeclarativeImportsPrivate::resolvedUri(), QPluginLoader::setFileName(), setFontSizeFromValue(), setWidthAttribute(), QSqlDriver::sqlStatement(), QSqlDriver::stripDelimitersImplementation(), QDB2Driver::tables(), QIBaseDriver::tables(), QUrl::toString(), translate_dashPattern(), QFileInfoGatherer::translateDriveName(), QCss::Parser::unquotedLexem(), and variantToString().

Data * d

Definition: qstring.h:618

◆ chop()

void QString::chop ( int n )

Removes n characters from the end of the string.

If n is greater than size(), the result is an empty string.

Example:

    QString str("LOGOUT\r\n");
    str.chop(2);
    // str == "LOGOUT"

If you want to remove characters from the beginning of the string, use remove() instead.

See also: truncate(), resize(), remove()

Definition at line 4623 of file qstring.cpp.

 {
     if (n > 0)
         resize(d->size - n);
 }

◆ clear()

void QString::clear ( )

inline

Clears the contents of the string and makes it empty.

See also: resize(), isEmpty()

Definition at line 723 of file qstring.h.

Referenced by QUnixPrintWidgetPrivate::_q_btnBrowseClicked(), QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QPixmapIconEngine::addPixmap(), Maemo::IcdPrivate::addrinfo(), QTextHtmlImporter::appendNodeText(), QNetworkAccessAuthenticationManager::cacheProxyCredentials(), QUrlPrivate::canonicalHost(), QProcessPrivate::Channel::Channel(), QDBusObjectPath::check(), QDBusSignature::check(), QScript::SyntaxChecker::checkSyntax(), QSqlTableModelPrivate::clear(), QXmlStreamStringRef::clear(), QFileInfoPrivate::clear(), QTextDocumentPrivate::clear(), QResourcePrivate::clear(), QUrlPrivate::clear(), QRegExpEngineKey::clear(), QAbstractSpinBoxPrivate::clearCache(), QNetworkSessionPrivateImpl::clearConfiguration(), QLabelPrivate::clearContents(), QFtpDTP::clearError(), QFtpPI::clearPendingCommands(), Maemo::IcdPrivate::clearState(), QDBusConnectionPrivate::closeConnection(), QPdfBaseEnginePrivate::closePrintDevice(), QWinInputContext::composition(), QIcdEngine::connectionStateSignalsSlot(), QNativeWifiEngine::connectToId(), QTextStreamPrivate::consume(), QDomImplementation::createDocumentType(), QDBusMetaObject::createMetaObject(), QAxBase::dynamicCallHelper(), QWinInputContext::endComposition(), QDomHandler::endEntity(), fbname(), QTextStreamPrivate::flushWriteBuffer(), fmtDateTime(), QXmlInputSource::fromRawData(), QXmlStreamReaderPrivate::getChar_helper(), getIBaseError(), QLocalSocketPrivate::init(), QDomDocumentTypePrivate::init(), QXmlSimpleReaderPrivate::init(), QXmlStreamReaderPrivate::init(), QCss::Parser::init(), QSharedMemoryPrivate::initKey(), QSettingsPrivate::iniUnescapedStringList(), QSqlDatabasePrivate::invalidateDb(), QLibraryPrivate::isPlugin(), QLibraryPrivate::load_sys(), QWhatsThat::mouseReleaseEvent(), QTextHtmlParser::newNode(), StringSplitter::next(), QDeclarativeXmlListModelPrivate::notifyQueryStarted(), QProcessPrivate::Channel::operator=(), QTextStream::operator>>(), operator>>(), QScriptParser::parse(), QUrlPrivate::parse(), QXmlStreamReaderPrivate::parse(), parseCombinedArgString(), QXmlSimpleReaderPrivate::parseDoctype(), QCss::Parser::parseElementName(), QXmlStreamReaderPrivate::parseError(), QXmlSimpleReaderPrivate::parseExternalID(), parseFontName(), QAuthenticatorPrivate::parseHttpResponse(), parseIp6(), QProcessPrivate::Channel::pipeFrom(), QProcessPrivate::Channel::pipeTo(), QTextStream::pos(), QPSQLResult::prepare(), QDBusConnectionPrivate::prepareHook(), QXmlNamespaceSupport::processName(), qDeallocatePreparedStmt(), qExtractSecurityPolicyFromString(), qGetStringData(), qt_fillFontDef(), QFileDialogPrivate::qt_mac_filedialog_event_proc(), qt_parseQconfig(), qt_split_namespace(), qt_win_get_save_file_name(), QPatternist::XSLTTokenizer::queueTextConstructor(), QConfFileSettingsPrivate::readIniFile(), QMdiSubWindowPrivate::removeBaseWidget(), QWinInputContext::reset(), QTextStreamPrivate::resetReadBuffer(), QLibraryPrivate::resolve_sys(), QUrl::resolved(), Maemo::IcdPrivate::scan(), QFileDialogPrivate::selectFile_sys(), QUrlPrivate::setAuthority(), QDeclarativeJS::Lexer::setCode(), QDBusConnectionPrivate::setConnection(), QUrl::setEncodedFragment(), QUrl::setEncodedPassword(), QUrl::setEncodedPath(), QUrlPrivate::setEncodedUserInfo(), QUrl::setEncodedUserName(), QFilePrivate::setError(), QFont::setFamily(), QLibrary::setLoadHints(), QFont::setStyleHint(), QUrlPrivate::setUserInfo(), QSettingsPrivate::splitArgs(), QFSCompleter::splitPath(), QCompleter::splitPath(), QSqlDriver::sqlStatement(), QFtpPI::startNextCmd(), Maemo::IcdPrivate::state(), Maemo::IcdPrivate::statistics(), QSQLiteDriver::tables(), QLibraryPrivate::unload_sys(), QAuthenticatorPrivate::updateCredentials(), and QNetworkSessionPrivateImpl::updateState().

724 { if (!isNull()) *this = QString(); }

QString::isNull

bool isNull() const

Returns true if this string is null; otherwise returns false.

Definition: qstring.h:505

Referenced by QFileSystemModelPrivate::_q_fileSystemChanged(), QStringRef::at(), QFontDatabase::bold(), QUnsortedModelEngine::buildIndices(), QFileSystemModelPrivate::caseInsensitiveLessThan(), QPatternist::StringComparator::compare(), QPatternist::CaseInsensitiveStringComparator::compare(), compare(), QLineControl::complete(), QVNCScreen::connect(), QTransformedScreen::connect(), QHttpNetworkConnectionPrivate::copyCredentials(), QTsLibPlugin::create(), QLinuxInputKbdDriver::create(), QLinuxTPMouseDriver::create(), QLinuxInputPlugin::create(), QNetworkAccessFileBackendFactory::create(), QNetworkAccessFtpBackendFactory::create(), declarations(), QFontDatabasePrivate::family(), QSortedModelEngine::filter(), findEncoding(), findObject(), QFontDatabase::font(), QtFontFamily::foundry(), QAudioOutputPrivate::freeBlocks(), QAudioInputPrivate::freeBlocks(), getFontWeight(), QStyleSheetStyle::hasStyleRule(), QTextHtmlParserNode::initializeProperties(), QFontDatabase::isBitmapScalable(), isCacheable(), QPatternist::LangFN::isLangMatch(), QUrl::isLocalFile(), QFontDatabase::isSmoothlyScalable(), QExtendedInformation::isSymLink(), QFontDatabase::italic(), QSortFilterProxyModel::lessThan(), loadFromDatabase(), QTextDocument::loadResource(), QAbstractItemModel::match(), QFileSystemModelPrivate::naturalCompare(), QFileSystemModelPrivate::nodeCaseInsensitiveLessThan(), QSvgStyleSelector::nodeNameEquals(), QAudioDeviceInfoInternal::open(), QAudioInputPrivate::open(), QAudioOutputPrivate::open(), QDirSortItemComparator::operator()(), QFileSystemModelPrivate::QFileSystemNode::operator<(), QStandardItem::operator<(), operator<(), QFileInfo::operator==(), QProcEnvKey::operator==(), QFileSystemModelPrivate::QFileSystemNode::operator==(), QDir::operator==(), QFileSystemModelPrivate::QFileSystemNode::operator>(), QXmlStreamReaderPrivate::parse(), parseBrushValue(), parseColorValue(), QFontDatabase::pointSizes(), qMatchCapStr(), QtPrivate::QStringList_contains(), QTsLibMouseHandler::QTsLibMouseHandler(), QCss::Declaration::rectValue(), registerFont(), QCoreApplication::removeLibraryPath(), QSqlRelationalTableModel::selectStatement(), QPrinter::setOutputFileName(), QFontDatabase::smoothSizes(), QSortedModelEngine::sortOrder(), QFontDatabase::styles(), QAudioDeviceInfoInternal::testSettings(), QDBusConnection::unregisterObject(), QDeclarativeEnginePrivate::urlToLocalFileOrQrc(), QPatternist::NCNameConstructor::validateTargetName(), and QFontDatabase::weight().

QString()

Constructs a null string.

Definition: qstring.h:879

◆ compare() [1/9]

int QString::compare ( const QString & s ) const

Definition at line 5037 of file qstring.cpp.

 {
     return ucstrcmp(constData(), length(), other.constData(), other.length());
 }

◆ compare() [2/9]

int QString::compare	(	const QString &	s,
		Qt::CaseSensitivity	cs
	)		const

Definition at line 5048 of file qstring.cpp.

 {
     if (cs == Qt::CaseSensitive)
         return ucstrcmp(constData(), length(), other.constData(), other.length());
     return ucstricmp(d->data, d->data + d->size, other.d->data, other.d->data + other.d->size);
 }

◆ compare() [3/9]

int QString::compare	(	const QLatin1String &	other,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 5075 of file qstring.cpp.

 {
     return compare_helper(unicode(), length(), other, cs);
 }

◆ compare() [4/9]

static int QString::compare	(	const QString &	s1,
		const QString &	s2
	)

inlinestatic

Definition at line 350 of file qstring.h.

351 { return s1.compare(s2); }

int compare(const QString &s) const

Definition: qstring.cpp:5037

◆ compare() [5/9]

int QString::compare	(	const QString &	s1,
		const QString &	s2,
		Qt::CaseSensitivity	cs
	)

inlinestatic

Compares s1 with s2 and returns an integer less than, equal to, or greater than zero if s1 is less than, equal to, or greater than s2.

Since: 4.2

If cs is Qt::CaseSensitive, the comparison is case sensitive; otherwise the comparison is case insensitive.

Case sensitive comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-visible strings with localeAwareCompare().

    int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
    int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
    int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

See also: operator==(), operator<(), operator>()

Definition at line 352 of file qstring.h.

353 { return s1.compare(s2, cs); }

int compare(const QString &s) const

Definition: qstring.cpp:5037

◆ compare() [6/9]

static int QString::compare	(	const QString &	s1,
		const QLatin1String &	s2,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

inlinestatic

Definition at line 355 of file qstring.h.

357 { return s1.compare(s2, cs); }

int compare(const QString &s) const

Definition: qstring.cpp:5037

◆ compare() [7/9]

static int QString::compare	(	const QLatin1String &	s1,
		const QString &	s2,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

inlinestatic

Definition at line 358 of file qstring.h.

360 { return -s2.compare(s1, cs); }

int compare(const QString &s) const

Definition: qstring.cpp:5037

◆ compare() [8/9]

int QString::compare	(	const QStringRef &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

inline

Definition at line 1245 of file qstring.h.

1246 { return QString::compare_helper(constData(), length(), s.constData(), s.length(), cs); }

int length() const

Returns the number of characters referred to by the string reference.

Definition: qstring.h:1116

int length() const

Returns the number of characters in this string.

Definition: qstring.h:696

const QChar * constData() const

Same as unicode().

Definition: qstring.h:1159

QString::compare_helper

static int compare_helper(const QChar *data1, int length1, const QChar *data2, int length2, Qt::CaseSensitivity cs=Qt::CaseSensitive)

Definition: qstring.cpp:5059

const QChar * constData() const

Returns a pointer to the data stored in the QString.

Definition: qstring.h:712

◆ compare() [9/9]

int QString::compare	(	const QString &	s1,
		const QStringRef &	s2,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

inlinestatic

Definition at line 1247 of file qstring.h.

1248 { return QString::compare_helper(s1.constData(), s1.length(), s2.constData(), s2.length(), cs); }

int length() const

Returns the number of characters referred to by the string reference.

Definition: qstring.h:1116

int length() const

Returns the number of characters in this string.

Definition: qstring.h:696

const QChar * constData() const

Same as unicode().

Definition: qstring.h:1159

QString::compare_helper

static int compare_helper(const QChar *data1, int length1, const QChar *data2, int length2, Qt::CaseSensitivity cs=Qt::CaseSensitive)

Definition: qstring.cpp:5059

const QChar * constData() const

Returns a pointer to the data stored in the QString.

Definition: qstring.h:712

◆ compare_helper() [1/2]

int QString::compare_helper	(	const QChar *	data1,
		int	length1,
		const QChar *	data2,
		int	length2,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

staticprivate

Warning: This function is not part of the public interface.

Since: 4.5

Definition at line 5059 of file qstring.cpp.

Referenced by compare(), and QStringRef::compare().

 {
     if (cs == Qt::CaseSensitive)
         return ucstrcmp(data1, length1, data2, length2);
     register const ushort *s1 = reinterpret_cast<const ushort *>(data1);
     register const ushort *s2 = reinterpret_cast<const ushort *>(data2);
     return ucstricmp(s1, s1 + length1, s2, s2 + length2);
 }

◆ compare_helper() [2/2]

int QString::compare_helper	(	const QChar *	data1,
		int	length1,
		QLatin1String	s2,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

staticprivate

Warning: This function is not part of the public interface.

Since: 4.5

Definition at line 5101 of file qstring.cpp.

 {
     const ushort *uc = reinterpret_cast<const ushort *>(data1);
     const ushort *e = uc + length1;
     const uchar *c = (uchar *)s2.latin1();
 
     if (!c)
         return length1;
 
     if (cs == Qt::CaseSensitive) {
         while (uc < e && *c && *uc == *c)
             uc++, c++;
 
         if (uc == e)
             return -*c;
 
         return *uc - *c;
     } else {
         return ucstricmp(uc, e, c);
     }
 }

◆ constBegin()

QString::const_iterator QString::constBegin ( ) const

inline

Returns a const STL-style iterator pointing to the first character in the string.

See also: begin(), constEnd()

Definition at line 892 of file qstring.h.

Referenced by QSvgFont::draw(), idFromUrl(), and QFileSystemEntry::isClean().

893 { return reinterpret_cast<const QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

Referenced by QTextCopyHelper::appendFragment(), QConcatenable< QString >::appendTo(), QTextEngine::attributes(), QDeclarativeCompiler::buildDynamicMeta(), QTextCodec::canEncode(), QFileSystemEngine::canonicalName(), compare(), QStringRef::compare(), QDeclarativeCompiler::completeComponentBuild(), QTextDocumentPrivate::compressPieceTable(), QAbstractConcatenable::convertFromAscii(), createFileFromTemplate(), QFileSystemEngine::createLink(), QScriptDeclarativeClass::createPersistentIdentifier(), createPolygonNode(), createPolylineNode(), QTextEngine::elidedText(), QAction::event(), QXmlInputSource::fetchData(), QTextCodec::fromUnicode(), QTextEncoder::fromUnicode(), QFileSystemEngine::getLinkTarget(), getText(), localeAwareCompare(), QStringRef::localeAwareCompare(), QLibraryInfo::location(), QFSFileEnginePrivate::nativeOpen(), QStyleSheetStyleSelector::nodeNameEquals(), QByteArray::operator!=(), operator+=(), QByteArray::operator<(), operator<(), operator<<(), QByteArray::operator<=(), QByteArray::operator==(), QByteArray::operator>(), QByteArray::operator>=(), QDeclarativeJS::Parser::parse(), parseAnimateTransformNode(), QDeclarativeStyledTextPrivate::parseAttribute(), QDeclarativeStyledTextPrivate::parseCloseTag(), QDeclarativeStyledTextPrivate::parseEntity(), parsePen(), QDeclarativeStyledTextPrivate::parseTag(), QDeclarativeStyledTextPrivate::parseValue(), QSQLiteResult::prepare(), QXmlNamespaceSupport::processName(), QPatternist::NamespaceSupport::processName(), QDeclarativeImportDatabase::QDeclarativeImportDatabase(), QFileSystemIterator::QFileSystemIterator(), qt_ACE_do(), qt_is_idn_enabled(), qt_string_normalize(), qt_u_strToCase(), QTextStreamPrivate::readPtr(), QDeclarativeBindingCompilerPrivate::registerLiteralString(), QFileSystemEngine::removeFile(), QFileSystemEngine::renameFile(), replace(), QDeclarativeCompiler::rewriteBinding(), QTextStreamPrivate::scan(), QAbstractXmlReceiver::sendAsNode(), QCoreApplication::setApplicationVersion(), QColor::setColorFromString(), QWSRegionCommand::setData(), ShaderEffectItem::setFragmentShader(), QDeclarativeTextInput::setPasswordCharacter(), QFileSystemEngine::setPermissions(), ShaderEffectItem::setVertexShader(), QFtpPI::startNextCmd(), QTextBlock::text(), QTextFragment::text(), QTextBlock::textDirection(), toDouble(), QUrl::toPunycode(), toPunycodeHelper(), QTest::toString(), XsdSchemaToken::toToken(), QPatternist::XSLTTokenLookup::toToken(), toUtf8(), QStringRef::toUtf8(), trimRef(), and QXmlSerializer::write().

ushort * data

Definition: qstring.h:606

◆ constData()

const QChar * QString::constData ( ) const

inline

Returns a pointer to the data stored in the QString.

The pointer can be used to access the characters that compose the string. For convenience, the data is '\0'-terminated.

Note that the pointer remains valid only as long as the string is not modified.

See also: data(), operator[]()

Definition at line 712 of file qstring.h.

713 { return reinterpret_cast<const QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ constEnd()

QString::const_iterator QString::constEnd ( ) const

inline

Returns a const STL-style iterator pointing to the imaginary item after the last item in the list.

See also: constBegin(), end()

Definition at line 898 of file qstring.h.

Referenced by QSvgFont::draw(), and QFileSystemEntry::isClean().

899 { return reinterpret_cast<const QChar*>(d->data + d->size); }

int size

Definition: qstring.h:605

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

Referenced by QHttpPrivate::_q_slotConnected(), QHttpPrivate::_q_slotReadyRead(), QFileDialogPrivate::_q_updateOkButton(), QNSOpenSavePanelDelegate::acceptableExtensionsForSave, QmlApplicationViewerPrivate::adjustPath(), QCoreApplication::applicationFilePath(), QStyleSheetStyleSelector::attribute(), QAudioDeviceInfoInternal::availableDevices(), QUrlPrivate::canonicalHost(), QODBCDriver::cleanup(), QXmlSerializer::comment(), QPatternist::DocumentProjector::comment(), QTransformedScreen::connect(), QConnmanEngine::connectToId(), QPatternist::ProcessingInstructionConstructor::data(), QKeySequencePrivate::decodeString(), QAudioDeviceInfoInternal::defaultOutputDevice(), QConnmanEngine::disconnectFromId(), DumpIDL(), QTextHtmlExporter::emitFontFamily(), QTextHtmlExporter::emitFragment(), QPatternist::MatchesFN::evaluateSingleton(), QMdiSubWindow::eventFilter(), QSortFilterProxyModel::filterAcceptsRow(), QPatternist::Numeric::fromLexical(), QPatternist::DerivedInteger< DerivedType >::fromLexical(), QDateTime::fromString(), QNetworkAccessFtpBackend::ftpRawCommandReply(), QAxScript::functions(), QBBSystemLocaleData::getCorrectFormat(), getFontWeight(), QConnmanManagerInterface::getPathForTechnology(), QGtkStylePrivate::getThemeName(), QScriptSyntaxHighlighter::highlightBlock(), QAxBase::initialize(), QPatternist::XSLTTokenizer::insideTemplate(), QDeclarativeDebugServer::instance(), isBypassed(), isHostExcluded(), QConnmanEngine::isRoamingAllowed(), QDateTimeEditPrivate::isSeparatorKey(), QtFontStyle::Key::Key(), QAxScript::load(), QDeclarativeDebugServerPrivate::loadConnectionPlugin(), QAbstractItemModel::match(), QXlibMime::mimeAtomForFormat(), networkChangeCallback(), QScriptEnginePrivate::newRegExp(), noBlockInString(), QFileSystemModelPrivate::node(), QAudioDeviceInfoInternal::open(), QODBCDriver::open(), QStringRef::operator=(), QHostAddressPrivate::parse(), QDateTimeParser::parse(), parse_locale_tag(), parseIp6(), QHostAddress::parseSubnet(), QGtkStyle::pixelMetric(), QXmlSerializer::processingInstruction(), QPatternist::DocumentProjector::processingInstruction(), QAudioDeviceInfoInternal::QAudioDeviceInfoInternal(), qExtractSecurityPolicyFromString(), qGetODBCVersion(), qIsEffectiveTLD(), QMultiInputContext::QMultiInputContext(), qNtlmPhase3(), QQnxMouseHandler::QQnxMouseHandler(), QtPrivate::QStringList_filter(), qt_aqua_get_known_size(), qt_create_commandline(), qt_format_to_attrib_list(), qt_parseQconfig(), qt_splitLocaleName(), QTextHtmlImporter::QTextHtmlImporter(), QFileSystemModel::setData(), QMdiSubWindowPrivate::setNewWindowTitle(), QDeclarativeValueTypeScriptClass::setProperty(), QDeclarativeObjectScriptClass::setProperty(), QTextBrowserPrivate::setSource(), QMacStyle::sizeFromContents(), QFSCompleter::splitPath(), QProcessPrivate::startDetached(), QXmlStreamReaderPrivate::startDocument(), QUrlPrivate::toEncoded(), totalDigitsForDecimal(), QFontSubset::toType1(), QFileDialogPrivate::typedFiles(), QDeclarativeTextPrivate::updateLayout(), QLabelPrivate::updateShortcut(), QFontDialogPrivate::updateStyles(), QXmlStreamWriter::writeAttribute(), QXmlStreamWriter::writeComment(), QXmlStreamWriter::writeEmptyElement(), QXmlStreamWriter::writeProcessingInstruction(), QXmlStreamWriter::writeStartElement(), and QX11Data::xdndMimeAtomForFormat().

ushort * data

Definition: qstring.h:606

◆ contains() [1/5]

QBool QString::contains	(	QChar	c,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

inline

Definition at line 904 of file qstring.h.

905 { return QBool(indexOf(c, 0, cs) != -1); }

Definition: qglobal.h:2013

int indexOf(QChar c, int from=0, Qt::CaseSensitivity cs=Qt::CaseSensitive) const

Definition: qstring.cpp:2838

◆ contains() [2/5]

QBool QString::contains	(	const QString &	str,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

inline

Returns true if this string contains an occurrence of the string str; otherwise returns false.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

Example:

QString str = "Peter Pan";

str.contains("peter", Qt::CaseInsensitive); // returns true

See also: indexOf(), count()

Definition at line 900 of file qstring.h.

901 { return QBool(indexOf(s, 0, cs) != -1); }

Definition: qglobal.h:2013

int indexOf(QChar c, int from=0, Qt::CaseSensitivity cs=Qt::CaseSensitive) const

Definition: qstring.cpp:2838

◆ contains() [3/5]

QBool QString::contains	(	const QStringRef &	str,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

inline

Returns true if this string contains an occurrence of the string reference str; otherwise returns false.

Since: 4.8

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

See also: indexOf(), count()

Definition at line 902 of file qstring.h.

903 { return QBool(indexOf(s, 0, cs) != -1); }

Definition: qglobal.h:2013

int indexOf(QChar c, int from=0, Qt::CaseSensitivity cs=Qt::CaseSensitive) const

Definition: qstring.cpp:2838

◆ contains() [4/5]

QBool QString::contains ( const QRegExp & rx ) const

inline

Definition at line 204 of file qstring.h.

204 { return QBool(indexOf(rx) != -1); }

Definition: qglobal.h:2013

int indexOf(QChar c, int from=0, Qt::CaseSensitivity cs=Qt::CaseSensitive) const

Definition: qstring.cpp:2838

◆ contains() [5/5]

QBool QString::contains ( QRegExp & rx ) const

inline

Definition at line 209 of file qstring.h.

209 { return QBool(indexOf(rx) != -1); }

Definition: qglobal.h:2013

Referenced by QFileDialogPrivate::_q_useNameFilter(), QNSOpenSavePanelDelegate::acceptableExtensionsForSave, QWizardPrivate::addField(), QDir::addResourceSearchPath(), QKeySequence::assign(), QPatternist::AccelTreeBuilder< true >::attribute(), QTextEngine::calculateTabWidth(), QAccessibleLineEdit::characterCount(), QDeclarativeCompiler::checkValidId(), count(), QStyledItemDelegate::displayText(), QMacStyle::drawControl(), QRegExp::escape(), QDeclarativeImportedNamespace::find(), QDateTimeParser::findAmPm(), QTest::formatResult(), QTextHtmlParserNode::hasOnlyWhitespace(), QDirModel::index(), QDeclarativePropertyPrivate::initProperty(), QAxServerBase::Load(), QLibraryPrivate::load_sys(), QFileSystemModelPrivate::naturalCompare(), QPatternist::XQueryTokenizer::nextToken(), QPatternist::XQueryTokenizer::normalizeEOL(), QStringRef::operator=(), parseIp6(), QDeclarativeStringConverters::pointFFromString(), QDeclarativeStringConverters::rectFFromString(), QItemDelegatePrivate::replaceNewLine(), QAxServerBase::Save(), QAccessibleLineEdit::selection(), QDeclarativeStringConverters::sizeFFromString(), subControlLayout(), QDeclarativeBindingCompilerPrivate::subscriptionIndex(), QPatternist::XQueryTokenizer::tokenizeStringLiteral(), totalDigitsForDecimal(), QDeclarativeStringConverters::vector3DFromString(), QXmlStreamWriter::writeAttribute(), QTextOdfWriter::writeBlock(), QXmlStreamWriter::writeEmptyElement(), and QXmlStreamWriter::writeStartElement().

int indexOf(QChar c, int from=0, Qt::CaseSensitivity cs=Qt::CaseSensitive) const

Definition: qstring.cpp:2838

◆ count() [1/5]

int QString::count ( ) const

inline

Definition at line 103 of file qstring.h.

103 { return d->size; }

int size

Definition: qstring.h:605

Referenced by append(), arg(), QLocalePrivate::bcp47Name(), canonicalOrderHelper(), QTextDocumentPrivate::compressPieceTable(), QCoreWlanEngine::connectToId(), containsProhibitedOuptut(), QGb18030Codec::convertToUnicode(), QIsciiCodec::convertToUnicode(), QSimpleTextCodec::convertToUnicode(), QLatin15Codec::convertToUnicode(), QGbkCodec::convertToUnicode(), QGb2312Codec::convertToUnicode(), createFileFromTemplate(), decomposeHelper(), QLocalePrivate::doubleToString(), QDragManager::drag(), QPainter::drawText(), escapedKey(), QProcessPrivate::execChild(), QTextStreamPrivate::fillReadBuffer(), QTextStreamPrivate::flushWriteBuffer(), QDir::fromNativeSeparators(), QRawFont::glyphIndexesForString(), QFontMetrics::inFontUcs4(), QFontMetricsF::inFontUcs4(), QSettingsPrivate::iniUnescapedStringList(), insert(), make_widget_eventUPP(), mapToLowerCase(), multiArg(), QResourceRoot::name(), QAxSelect::on_ActiveXList_clicked(), QAxSelect::on_ActiveXList_doubleClicked(), operator+=(), operator<<(), operator>>(), QXmlStreamReaderPrivate::parse(), parse_locale_tag(), parseFontName(), QTextDocumentPrivate::plainText(), QProcessPrivate::processStarted(), QTextStreamPrivate::putString(), qt_ACE_do(), qt_format_text(), qt_nameprep(), qt_string_normalize(), replace(), replaceWithSpace(), QXlibClipboard::sendSelection(), toAscii(), toLatin1_helper(), QDir::toNativeSeparators(), QTextDocument::toPlainText(), toPunycodeHelper(), AnchorVertex::toString(), QTextDecoder::toUnicode(), QCharRef::unicode(), QLineControl::updateDisplayText(), updateValue(), and QFontMetrics::width().

Data * d

Definition: qstring.h:618

◆ count() [2/5]

int QString::count	(	QChar	c,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3234 of file qstring.cpp.

 {
     return qt_string_count(unicode(), size(), ch, cs);
     }

◆ count() [3/5]

int QString::count	(	const QString &	str,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns the number of (potentially overlapping) occurrences of the string str in this string.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

See also: contains(), indexOf()

Definition at line 3220 of file qstring.cpp.

 {
     return qt_string_count(unicode(), size(), str.unicode(), str.size(), cs);
 }

◆ count() [4/5]

int QString::count	(	const QStringRef &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3253 of file qstring.cpp.

 {
     return qt_string_count(unicode(), size(), str.unicode(), str.size(), cs);
 }

◆ count() [5/5]

int QString::count ( const QRegExp & rx ) const

Definition at line 3429 of file qstring.cpp.

 {
     QRegExp rx2(rx);
     int count = 0;
     int index = -1;
     int len = length();
     while (index < len - 1) {                 // count overlapping matches
         index = rx2.indexIn(*this, index + 1);
         if (index == -1)
             break;
         count++;
     }
     return count;
 }

◆ data() [1/2]

QChar * QString::data ( )

inline

Returns a pointer to the data stored in the QString.

The pointer can be used to access and modify the characters that compose the string. For convenience, the data is '\0'-terminated.

Example:

    QString str = "Hello world";
    QChar *data = str.data();
    while (!data->isNull()) {
        qDebug() << data->unicode();
        ++data;
    }

Note that the pointer remains valid only as long as the string is not modified by other means. For read-only access, constData() is faster because it never causes a deep copy to occur.

See also: constData(), operator[]()

Definition at line 710 of file qstring.h.

711 { detach(); return reinterpret_cast<QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

QString::detach

void detach()

Definition: qstring.h:714

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ data() [2/2]

const QChar * QString::data ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 708 of file qstring.h.

709 { return reinterpret_cast<const QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ data_ptr()

DataPtr & QString::data_ptr ( )

inline

Warning: This function is not part of the public interface.

Definition at line 650 of file qstring.h.

650 { return d; }

Data * d

Definition: qstring.h:618

◆ detach()

void QString::detach ( )

inline

Warning: This function is not part of the public interface.

Definition at line 714 of file qstring.h.

Referenced by begin(), QDBusConnectionPrivate::connectSignal(), data(), QDBusConnectionPrivate::disconnectSignal(), end(), QCharRef::operator=(), remove(), replace(), replace_helper(), and toCaseFolded().

715 { if (d->ref != 1 || d->data != d->array) realloc(); }

QString::realloc

void realloc()

Definition: qstring.cpp:1472

QBasicAtomicInt ref

Definition: qstring.h:604

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

QString::Data::array

ushort array[1]

Definition: qstring.h:614

◆ end() [1/2]

QString::iterator QString::end ( )

inline

Returns an STL-style iterator pointing to the imaginary character after the last character in the string.

See also: begin(), constEnd()

Definition at line 894 of file qstring.h.

Referenced by isStringRightToLeft(), lastIndexOfHelper(), multiArg(), qFindString(), repeated(), section(), split(), trimmed(), and updateProperties().

895 { detach(); return reinterpret_cast<QChar*>(d->data + d->size); }

int size

Definition: qstring.h:605

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

QString::detach

void detach()

Definition: qstring.h:714

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ end() [2/2]

QString::const_iterator QString::end ( ) const

inline

Definition at line 896 of file qstring.h.

897 { return reinterpret_cast<const QChar*>(d->data + d->size); }

int size

Definition: qstring.h:605

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

Referenced by QUnixPrintWidgetPrivate::_q_btnBrowseClicked(), _q_parseDosDir(), QDeclarativeImportsPrivate::add(), QFileDialogPrivate::addDefaultSuffixToFiles(), QZipWriter::addDirectory(), QSvgIconEngine::addFile(), QWindowsFileSystemWatcherEngine::addPaths(), QPollingFileSystemWatcherEngine::addPaths(), QDir::cleanPath(), QVNCScreen::connect(), QMultiScreen::connect(), QTransformedScreen::connect(), QFileSystemEngine::createDirectory(), QAbstractFileEngineIterator::currentFilePath(), QDeclarativeListModelParser::definesEmptyList(), QSvgText::draw(), QPSPrintEnginePrivate::emitHeader(), errorCodeToString(), QDB2Driver::escapeIdentifier(), QIBaseDriver::escapeIdentifier(), QSQLite2Driver::escapeIdentifier(), QTDSDriver::escapeIdentifier(), QMYSQLDriver::escapeIdentifier(), QPSQLDriver::escapeIdentifier(), QODBCDriver::escapeIdentifier(), QNetworkDiskCache::expire(), familyList(), QFileSystemModelPrivate::filePath(), QFileSystemEngine::fillMetaData(), find_translation(), QTextBrowserPrivate::findFile(), QResourceRoot::findNode(), QDateTime::fromString(), getFindData(), QFileSystemEngine::getLinkTarget(), QDirModel::index(), QSQLite2ResultPrivate::init(), intValueHelper(), isDirPath(), QMYSQLDriver::isIdentifierEscapedImplementation(), QODBCDriver::isIdentifierEscapedImplementation(), QSqlDriver::isIdentifierEscapedImplementation(), QLibrary::isLibrary(), isParentDomain(), QUrl::isParentOf(), isParentPath(), QLibraryPrivate::isPlugin(), QDBusUtil::isValidObjectPath(), jump(), launchWebBrowser(), QCss::ValueExtractor::lengthValue(), QSvgTinyDocument::load(), QTranslator::load(), QSystemLibrary::load(), QAxScriptManager::load(), QLibraryPrivate::load_sys(), loadOpenSslWin32(), QFSFileEnginePrivate::longFileName(), QAbstractItemModel::match(), QDirModelPrivate::name(), QFileSystemModelPrivate::node(), QDBusXmlParser::objectTree(), QNetworkAccessFtpBackend::open(), QStringRef::operator=(), parseAnimateColorNode(), parseAnimateTransformNode(), QTextHtmlParser::parseCloseTag(), parseLength(), QFSCompleter::pathFromIndex(), QFileSystemIterator::QFileSystemIterator(), QIconTheme::QIconTheme(), qmlFilesInDirectory(), QRenderRule::QRenderRule(), qt_create_commandline(), qt_init(), qt_mac_menu_merge_action(), QWizardField::QWizardField(), QCacheItem::read(), readImage(), readLink(), QFtpPI::readyRead(), QCss::Declaration::realValue(), QAxFactory::registerActiveObject(), QNetworkDiskCachePrivate::removeFile(), QWindowsFileSystemWatcherEngine::removePaths(), QDeclarativeImportsPrivate::resolvedUri(), QFileSystemModelPrivate::QFileSystemNode::retranslateStrings(), runningUnderDebugger(), QAxBase::setControl(), QFileDialog::setDirectory(), setFontSizeFromValue(), QDirPrivate::setPath(), setWidthAttribute(), QFSCompleter::splitPath(), QSqlDriver::sqlStatement(), QSettingsPrivate::stringToVariant(), QAbstractSpinBoxPrivate::stripped(), QSqlError::text(), QPollingFileSystemWatcherEngine::timeout(), QUrl::toString(), QFileInfoGatherer::translateDriveName(), QFileSystemModelPrivate::QFileSystemNode::updateIcon(), QSpinBoxValidator::validate(), and QXmlStreamWriter::writeComment().

ushort * data

Definition: qstring.h:606

◆ endsWith() [1/4]

bool QString::endsWith	(	const QString &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns true if the string ends with s; otherwise returns false.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

    QString str = "Bananas";
    str.endsWith("anas");         // returns true
    str.endsWith("pple");         // returns false

See also: startsWith()

Definition at line 3796 of file qstring.cpp.

 {
     return qt_ends_with(isNull() ? 0 : unicode(), size(),
                         s.isNull() ? 0 : s.unicode(), s.size(), cs);
     }

◆ endsWith() [2/4]

bool QString::endsWith	(	const QStringRef &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3816 of file qstring.cpp.

 {
     return qt_ends_with(isNull() ? 0 : unicode(), size(),
                         s.isNull() ? 0 : s.unicode(), s.size(), cs);
 }

◆ endsWith() [3/4]

bool QString::endsWith	(	const QLatin1String &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3826 of file qstring.cpp.

 {
     return qt_ends_with(isNull() ? 0 : unicode(), size(), s, cs);
 }

◆ endsWith() [4/4]

bool QString::endsWith	(	const QChar &	c,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3837 of file qstring.cpp.

 {
     return d->size
            && (cs == Qt::CaseSensitive
                ? d->data[d->size - 1] == c
                : foldCase(d->data[d->size - 1]) == foldCase(c.unicode()));
 }

◆ expand()

void QString::expand ( int i )

private

Definition at line 1477 of file qstring.cpp.

Referenced by insert(), and QCharRef::operator=().

 {
     int sz = d->size;
     resize(qMax(i + 1, sz));
     if (d->size - 1 > sz) {
         ushort *n = d->data + d->size - 1;
         ushort *e = d->data + sz;
         while (n != e)
            * --n = ' ';
     }
 }

◆ fill()

QString & QString::fill	(	QChar	ch,
		int	size = `-1`
	)

Sets every character in the string to character ch.

If size is different from -1 (default), the string is resized to size beforehand.

Example:

    QString str = "Berlin";
    str.fill('z');
    // str == "zzzzzz"
    str.fill('A', 2);
    // str == "AA"

See also: resize()

Definition at line 4641 of file qstring.cpp.

Referenced by QPatternist::XsdSchemaDebugger::dumpInheritance(), QPatternist::XsdSchemaDebugger::dumpParticle(), int2string(), leftJustified(), QSvgPaintEngine::qbrushToSvg(), rightJustified(), QDateTimeParser::sectionFormat(), QLCDNumber::setDigitCount(), and QLineControl::updateDisplayText().

 {
     resize(size < 0 ? d->size : size);
     if (d->size) {
         QChar *i = (QChar*)d->data + d->size;
         QChar *b = (QChar*)d->data;
         while (i != b)
            *--i = ch;
     }
     return *this;
 }

◆ free()

void QString::free ( Data * d )

staticprivate

Definition at line 1311 of file qstring.cpp.

Referenced by operator=(), realloc(), resize(), and ~QString().

 {
 #ifdef QT3_SUPPORT
     if (d->asciiCache) {
         QMutexLocker locker(asciiCacheMutex());
         Q_ASSERT(asciiCache);
         asciiCache->remove(d);
     }
 #endif
     qFree(d);
 }

◆ fromAscii()

QString QString::fromAscii	(	const char *	str,
		int	size = `-1`
	)

static

Returns a QString initialized with the first size characters from the string str.

If size is -1 (default), it is taken to be qstrlen(str).

Note that, despite the name, this function actually uses the codec defined by QTextCodec::setCodecForCStrings() to convert str to Unicode. Depending on the codec, it may not accept valid US-ASCII (ANSI X3.4-1986) input. If no codec has been set, this function does the same as fromLatin1().

See also: toAscii(), fromLatin1(), fromUtf8(), fromLocal8Bit()

Definition at line 4276 of file qstring.cpp.

Referenced by QDateTimeEditPrivate::_q_editorCursorPositionChanged(), QHttpPrivate::_q_slotReadyRead(), QHttpPrivate::_q_slotSendRequest(), QGraphicsAnchorLayoutPrivate::addAnchor_helper(), QBasicUnixFontDatabase::addTTFile(), QFontDatabasePrivate::addTTFile(), append(), QSQLite2Driver::beginTransaction(), QGraphicsWidget::close(), QSQLite2Driver::commitTransaction(), convert(), QAbstractConcatenable::convertFromAscii(), Graph< AnchorVertex, AnchorData >::createEdge(), createSequence(), QLayoutPrivate::createSpacerItem(), QPSQLResult::data(), QGridLayoutRowInfo::dump(), QGraphicsAnchorLayoutPrivate::dumpGraph(), QSimplex::dumpMatrix(), QPatternist::EncodeString::evaluateSingleton(), QRadioButton::event(), QCheckBox::event(), QDB2Result::exec(), QWSSoundServerPrivate::feedDevice(), QSQLite2ResultPrivate::fetchNext(), QSQLite2ResultPrivate::finalize(), QSplitterPrivate::findWidget(), QHttpThreadDelegate::finishedSlot(), QXmlInputSource::fromRawData(), fromStdString(), QSslSocketBackendPrivate::getErrorsFromOpenSsl(), QPSQLDriverPrivate::getPSQLVersion(), getSegments(), QBBVirtualKeyboardBps::handleLocaleEvent(), QPushButtonPrivate::hitButton(), QSQLite2ResultPrivate::init(), QStatusBarPrivate::messageRect(), QGroupBox::mouseReleaseEvent(), QSQLite2Driver::open(), QLatin1String::operator!=(), operator!=(), operator+(), operator+=(), QByteArray::operator<(), operator<(), QLatin1String::operator<(), operator<(), QDebug::operator<<(), operator<<(), QTextStream::operator<<(), QByteArray::operator<=(), operator<=(), QLatin1String::operator<=(), operator<=(), QLatin1String::operator==(), operator==(), QByteArray::operator>(), operator>(), QLatin1String::operator>(), operator>(), QByteArray::operator>=(), operator>=(), QLatin1String::operator>=(), operator>=(), QToolBoxButton::paintEvent(), ParallelAnchorData::ParallelAnchorData(), QHttpNetworkConnectionPrivate::prepareRequest(), prepend(), QBoxLayout::QBoxLayout(), QComboBox::QComboBox(), QCopChannel::QCopChannel(), QDial::QDial(), QDialog::QDialog(), QDoubleValidator::QDoubleValidator(), QFrame::QFrame(), QGridLayout::QGridLayout(), QHBoxLayout::QHBoxLayout(), QImage::QImage(), QIntValidator::QIntValidator(), QLabel::QLabel(), QLineEdit::QLineEdit(), QMainWindow::QMainWindow(), QMenuBar::QMenuBar(), QObject::QObject(), QRegExpValidator::QRegExpValidator(), QScriptValue::QScriptValue(), QScrollBar::QScrollBar(), QSignalMapper::QSignalMapper(), QSizeGrip::QSizeGrip(), QSlider::QSlider(), QSocketNotifier::QSocketNotifier(), QSound::QSound(), QSpinBox::QSpinBox(), qStringComparisonHelper(), qt_get_screen(), QTabWidget::QTabWidget(), qTdsMsgHandler(), QTextBrowser::QTextBrowser(), QTextEdit::QTextEdit(), QTimer::QTimer(), QToolBar::QToolBar(), QToolButton::QToolButton(), QTranslator::QTranslator(), QValidator::QValidator(), QVariant::QVariant(), QVBoxLayout::QVBoxLayout(), QWidget::QWidget(), QWorkspace::QWorkspace(), QWSServer::QWSServer(), QWSSoundServerPrivate::QWSSoundServerPrivate(), QFtpPI::readyRead(), QIBaseResult::record(), Graph< AnchorVertex, AnchorData >::removeEdge(), QGraphicsAnchorLayoutPrivate::replaceVertex(), QSQLite2Result::reset(), QTDSResult::reset(), QLibraryPrivate::resolve_sys(), QSQLite2Driver::rollbackTransaction(), SequentialAnchorData::SequentialAnchorData(), Graph< AnchorVertex, AnchorData >::serializeToDot(), QWSServer::setDefaultKeyboard(), QWSServer::setDefaultMouse(), QAction::setFont(), QAbstractButton::setIconSize(), QImage::setText(), setupDBusInterface(), QMessageBox::setWindowModality(), QGraphicsAnchorLayoutPrivate::simplifyGraph(), QHttpThreadDelegate::synchronousFinishedSlot(), Graph< AnchorVertex, AnchorData >::takeEdge(), QAccessibleItemRow::text(), QImage::text(), QTextHtmlExporter::toHtml(), AnchorVertex::toString(), QSimplexConstraint::toString(), AnchorData::toString(), GraphPath::toString(), QWSSoundServerClient::tryReadCommand(), QFontEngineFTRawFont::updateFamilyNameAndStyle(), and QAbstractSpinBoxPrivate::variantCompare().

 {
     return QString(fromAscii_helper(str, size), 0);
 }

◆ fromAscii_helper()

QString::Data * QString::fromAscii_helper	(	const char *	str,
		int	size = `-1`
	)

staticprivate

Definition at line 4155 of file qstring.cpp.

Referenced by fromAscii().

 {
 #ifndef QT_NO_TEXTCODEC
     if (codecForCStrings) {
         Data *d;
         if (!str) {
             d = &shared_null;
             d->ref.ref();
         } else if (size == 0 || (!*str && size < 0)) {
             d = &shared_empty;
             d->ref.ref();
         } else {
             if (size < 0)
                 size = qstrlen(str);
             QString s = codecForCStrings->toUnicode(str, size);
             d = s.d;
             d->ref.ref();
         }
         return d;
     }
 #endif
     return fromLatin1_helper(str, size);
 }

◆ fromLatin1()

QString QString::fromLatin1	(	const char *	str,
		int	size = `-1`
	)

static

Returns a QString initialized with the first size characters of the Latin-1 string str.

If size is -1 (default), it is taken to be qstrlen(str).

See also: toLatin1(), fromAscii(), fromUtf8(), fromLocal8Bit()

Definition at line 4188 of file qstring.cpp.

 {
     return QString(fromLatin1_helper(str, size), 0);
 }

◆ fromLatin1_helper()

QString::Data * QString::fromLatin1_helper	(	const char *	str,
		int	size = `-1`
	)

staticprivate

Definition at line 4104 of file qstring.cpp.

Referenced by fromAscii_helper(), and fromLatin1().

 {
     Data *d;
     if (!str) {
         d = &shared_null;
         d->ref.ref();
     } else if (size == 0 || (!*str && size < 0)) {
         d = &shared_empty;
         d->ref.ref();
     } else {
         if (size < 0)
             size = qstrlen(str);
         d = static_cast<Data *>(qMalloc(sizeof(Data) + size * sizeof(QChar)));
         Q_CHECK_PTR(d);
         d->ref = 1;
         d->alloc = d->size = size;
         d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
         d->data = d->array;
         d->array[size] = '\0';
         ushort *dst = d->data;
         /* SIMD:
          * Unpacking with SSE has been shown to improve performance on recent CPUs
          * The same method gives no improvement with NEON.
          */
 #if defined(QT_ALWAYS_HAVE_SSE2)
         if (size >= 16) {
             int chunkCount = size >> 4; // divided by 16
             const __m128i nullMask = _mm_set1_epi32(0);
             for (int i = 0; i < chunkCount; ++i) {
                 const __m128i chunk = _mm_loadu_si128((__m128i*)str); // load
                 str += 16;
 
                 // unpack the first 8 bytes, padding with zeros
                 const __m128i firstHalf = _mm_unpacklo_epi8(chunk, nullMask);
                 _mm_storeu_si128((__m128i*)dst, firstHalf); // store
                 dst += 8;
 
                 // unpack the last 8 bytes, padding with zeros
                 const __m128i secondHalf = _mm_unpackhi_epi8 (chunk, nullMask);
                 _mm_storeu_si128((__m128i*)dst, secondHalf); // store
                 dst += 8;
             }
             size = size % 16;
         }
 #endif
         while (size--)
             *dst++ = (uchar)*str++;
     }
     return d;
 }

◆ fromLocal8Bit()

QString QString::fromLocal8Bit	(	const char *	str,
		int	size = `-1`
	)

static

Returns a QString initialized with the first size characters of the 8-bit string str.

If size is -1 (default), it is taken to be qstrlen(str).

QTextCodec::codecForLocale() is used to perform the conversion.

See also: toLocal8Bit(), fromAscii(), fromLatin1(), fromUtf8()

Definition at line 4245 of file qstring.cpp.

Referenced by QUnixPrintWidgetPrivate::_q_printerChanged(), QCoreApplication::applicationFilePath(), QUnixPrintWidgetPrivate::applyPrinterProperties(), QApplicationPrivate::applyX11SpecificCommandLineArguments(), QCoreApplication::arguments(), QFileSystemEngine::canonicalName(), QCUPSSupport::collectMarkedOptionsHelper(), QApplicationPrivate::construct(), QWindowsMimeText::convertToMime(), QWindowsMimeURI::convertToMime(), dlIterateCallback(), QtopiaPrintEngine::end(), QZipReader::fileData(), QZipPrivate::fillFileInfo(), QPlatformFontDatabase::fontDir(), fontPath(), QHostInfoAgent::fromName(), QFileDialogPrivate::getEnvironmentVariable(), getMacLocaleName(), QGtkStylePrivate::getThemeName(), getWinLocaleName(), QTDSResult::gotoNext(), interfaceListingWin2k(), interfaceListingWinXP(), isDirPath(), QKde::kdeHome(), launchWebBrowser(), QLibraryInfo::licensee(), QAxScriptManager::load(), locale_decode(), QHostInfo::localHostName(), QLibraryInfo::location(), QXlibMime::mimeConvertToFormat(), QProcessEnvironmentPrivate::OrderedMutexLocker::OrderedMutexLocker(), parseGeometry(), QPlatformFontDatabase::populateFontDatabase(), QApplicationPrivate::process_cmdline(), QCoreApplicationPrivate::processCommandLineArguments(), qCmdLineArgs(), qdlerror(), qMakeError(), QPdfBaseEngine::QPdfBaseEngine(), QRuntimeGraphicsSystem::QRuntimeGraphicsSystem(), qt_create_commandline(), qt_error_string(), qt_getLprPrinters(), qt_guiPlatformPlugin(), qt_init(), qt_parseEtcLpPrinters(), qt_parsePrintcap(), qt_parsePrintersConf(), qt_parseSpoolInterface(), qt_set_qws_resources(), qt_set_x11_resources(), qt_tildeExpansion(), qt_wstate_iconified(), QUnixPrintWidgetPrivate::QUnixPrintWidgetPrivate(), qWinMsgHandler(), qwsFontPath(), QWSTslibMouseHandlerPrivate::QWSTslibMouseHandlerPrivate(), QXlibDisplay::QXlibDisplay(), QWSCalibratedMouseHandler::readCalibration(), QPSQLResult::record(), QXIMInputContext::reset(), QPageSetupWidget::selectPrinter(), QPPDOptionsEditor::setEditorData(), QSmSocketReceiver::socketActivated(), standardLibraryErrorString(), QProcessPrivate::startDetached(), QProcessPrivate::startProcess(), QApplication::style(), QProcess::systemEnvironment(), QCUPSSupport::tempFd(), timeZone(), translateWSAError(), QWSCalibratedMouseHandler::writeCalibration(), QX11Data::xdndMimeConvertToFormat(), and xic_draw_callback().

 {
     if (!str)
         return QString();
     if (size == 0 || (!*str && size < 0))
         return QLatin1String("");
 #if !defined(QT_NO_TEXTCODEC)
     if (size < 0)
         size = qstrlen(str);
     QTextCodec *codec = QTextCodec::codecForLocale();
     if (codec)
         return codec->toUnicode(str, size);
 #endif // !QT_NO_TEXTCODEC
     return fromLatin1(str, size);
 }

◆ fromRawData()

QString QString::fromRawData	(	const QChar *	unicode,
		int	size
	)

static

Constructs a QString that uses the first size Unicode characters in the array unicode.

The data in unicode is not copied. The caller must be able to guarantee that unicode will not be deleted or modified as long as the QString (or an unmodified copy of it) exists.

Any attempts to modify the QString or copies of it will cause it to create a deep copy of the data, ensuring that the raw data isn't modified.

Here's an example of how we can use a QRegExp on raw data in memory without requiring to copy the data into a QString:

    QRegExp pattern;
    static const QChar unicode[] = {
            0x005A, 0x007F, 0x00A4, 0x0060,
            0x1009, 0x0020, 0x0020};
    int size = sizeof(unicode) / sizeof(QChar);
    QString str = QString::fromRawData(unicode, size);
    if (str.contains(QRegExp(pattern))) {
        // ...

}

Warning: A string created with fromRawData() is not '\0'-terminated, unless the raw data contains a '\0' character at position size. This means unicode() will not return a '\0'-terminated string (although utf16() does, at the cost of copying the raw data).

See also: fromUtf16(), setRawData()

Definition at line 7673 of file qstring.cpp.

Referenced by QFontMetrics::charWidth(), QSvgPaintEngine::drawTextItem(), QRasterPaintEngine::drawTextItem(), getLocaleData(), getLocaleListData(), QDeclarativeExpressionPrivate::init(), launchWebBrowser(), QDeclarativeVMEMetaObject::method(), QXlibMime::mimeConvertToFormat(), QDeclarativeCompiledBindingsPrivate::run(), setRawData(), QTextBlock::text(), XsdSchemaToken::toString(), QPatternist::XSLTTokenLookup::toString(), and QX11Data::xdndMimeConvertToFormat().

 {
     Data *x = static_cast<Data *>(qMalloc(sizeof(Data)));
     Q_CHECK_PTR(x);
     if (unicode) {
         x->data = (ushort *)unicode;
     } else {
         x->data = x->array;
         size = 0;
     }
     x->ref = 1;
     x->alloc = x->size = size;
     *x->array = '\0';
     x->clean = x->asciiCache = x->simpletext = x->righttoleft = x->capacity = 0;
     return QString(x, 0);
 }

◆ fromStdString()

QString QString::fromStdString ( const std::string & str )

inlinestatic

Returns a copy of the str string.

The given string is converted to Unicode using the fromAscii() function.

This constructor is only available if Qt is configured with STL compatibility enabled.

See also: fromAscii(), fromLatin1(), fromLocal8Bit(), fromUtf8()

Definition at line 1047 of file qstring.h.

1048 { return fromAscii(s.data(), int(s.size())); }

Referenced by QWizardPrivate::_q_handleFieldObjectDestroyed(), QScriptDebuggerLocalsWidgetPrivate::_q_insertCompletion(), QScriptDebuggerLocalsWidgetPrivate::_q_onCompletionTaskFinished(), QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QXmlStreamPrivateTagStack::addToStringStorage(), QCss::StyleSheet::buildIndexes(), decimalForm(), QPatternist::LocalNameTest::displayName(), QPatternist::QNameTest::displayName(), exponentForm(), QTest::formatResult(), QUrl::fromPunycode(), insert(), QByteArray::insert(), QDomCharacterDataPrivate::insertData(), QAccessibleSimpleEditableTextInterface::insertText(), int2string(), QLineControl::internalInsert(), QLineControl::internalRedo(), QLineControl::internalUndo(), launchWebBrowser(), QLibraryPrivate::load_sys(), QLocalePrivate::longLongToString(), QDateTimeParser::parseSection(), QAccessibleSimpleEditableTextInterface::pasteText(), QDateTimeParser::potentialValue(), qDateTimeFromString(), qt_create_commandline(), QXmlStreamReader::readElementText(), toPunycodeHelper(), AnchorVertex::toString(), QLocalePrivate::unsLongLongToString(), and QTextEngine::validate().

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ fromStdWString()

QString QString::fromStdWString ( const std::wstring & str )

inlinestatic

Returns a copy of the str string.

The given string is assumed to be encoded in utf16 if the size of wchar_t is 2 bytes (e.g. on windows) and ucs4 if the size of wchar_t is 4 bytes (most Unix systems).

This method is only available if Qt is configured with STL compatibility enabled.

See also: fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4()

Definition at line 1065 of file qstring.h.

1066 { return fromWCharArray(s.data(), int(s.size())); }

QString::fromWCharArray

static QString fromWCharArray(const wchar_t *, int size=-1)

Returns a copy of the string, where the encoding of string depends on the size of wchar...

Definition: qstring.cpp:1019

◆ fromUcs4()

QString QString::fromUcs4	(	const uint *	unicode,
		int	size = `-1`
	)

static

Returns a QString initialized with the first size characters of the Unicode string unicode (ISO-10646-UCS-4 encoded).

Since: 4.2

If size is -1 (default), unicode must be terminated with a 0.

See also: toUcs4(), fromUtf16(), utf16(), setUtf16(), fromWCharArray()

Definition at line 4356 of file qstring.cpp.

Referenced by fromSQLTCHAR(), fromWCharArray(), QFontMetrics::inFontUcs4(), QFontMetricsF::inFontUcs4(), and QXmlStreamReaderPrivate::parse().

 {
     if (!unicode)
         return QString();
     if (size < 0) {
         size = 0;
         while (unicode[size] != 0)
             ++size;
     }
     return QUtf32::convertToUnicode((const char *)unicode, size*4, 0);
 }

◆ fromUtf16()

QString QString::fromUtf16	(	const ushort *	unicode,
		int	size = `-1`
	)

static

Returns a QString initialized with the first size characters of the Unicode string unicode (ISO-10646-UTF-16 encoded).

If size is -1 (default), unicode must be terminated with a 0.

This function checks for a Byte Order Mark (BOM). If it is missing, host byte order is assumed.

This function is slow compared to the other Unicode conversions. Use QString(const QChar *, int) or QString(const QChar *) if possible.

QString makes a deep copy of the Unicode data.

See also: utf16(), setUtf16()

Definition at line 4329 of file qstring.cpp.

Referenced by QChar::decomposition(), fromSQLTCHAR(), fromWCharArray(), launchWebBrowser(), QNlaThread::parseQuerySet(), and qMakeError().

 {
     if (!unicode)
         return QString();
     if (size < 0) {
         size = 0;
         while (unicode[size] != 0)
             ++size;
     }
     return QUtf16::convertToUnicode((const char *)unicode, size*2, 0);
 }

◆ fromUtf8()

QString QString::fromUtf8	(	const char *	str,
		int	size = `-1`
	)

static

Returns a QString initialized with the first size bytes of the UTF-8 string str.

If size is -1 (default), it is taken to be qstrlen(str).

UTF-8 is a Unicode codec and can represent all characters in a Unicode string like QString. However, invalid sequences are possible with UTF-8 and, if any such are found, they will be replaced with one or more "replacement characters", or suppressed. These include non-Unicode sequences, non-characters, overlong sequences or surrogate codepoints encoded into UTF-8.

Non-characters are codepoints that the Unicode standard reserves and must not be used in text interchange. They are the last two codepoints in each Unicode Plane (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE, etc.), as well as 16 codepoints in the range U+FDD0..U+FDDF, inclusive.

See also: toUtf8(), fromAscii(), fromLatin1(), fromLocal8Bit()

Definition at line 4302 of file qstring.cpp.

 {
     if (!str)
         return QString();
     if (size < 0)
         size = qstrlen(str);
 
     return QUtf8::convertToUnicode(str, size, 0);
 }

◆ fromWCharArray()

QString QString::fromWCharArray	(	const wchar_t *	string,
		int	size = `-1`
	)

static

Returns a copy of the string, where the encoding of string depends on the size of wchar.

Since: 4.2

If wchar is 4 bytes, the string is interpreted as ucs-4, if wchar is 2 bytes it is interpreted as ucs-2.

If size is -1 (default), the string has to be 0 terminated.

See also: fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4(), fromStdWString()

Definition at line 1019 of file qstring.cpp.

 {
     if (sizeof(wchar_t) == sizeof(QChar)) {
         return fromUtf16((const ushort *)string, size);
     } else {
         return fromUcs4((uint *)string, size);
     }
 }

◆ grow()

int QString::grow ( int size )

staticprivate

Definition at line 822 of file qstring.cpp.

Referenced by append(), and resize().

 {
     return qAllocMore(size * sizeof(QChar), sizeof(Data)) / sizeof(QChar);
 }

◆ indexOf() [1/6]

int QString::indexOf	(	QChar	c,
		int	from = `0`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 2838 of file qstring.cpp.

 {
     return findChar(unicode(), length(), ch, from, cs);
 }

◆ indexOf() [2/6]

int QString::indexOf	(	const QString &	str,
		int	from = `0`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns the index position of the first occurrence of the string str in this string, searching forward from index position from.

Returns -1 if str is not found.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

Example:

    QString x = "sticky question";
    QString y = "sti";
    x.indexOf(y);               // returns 0
    x.indexOf(y, 1);            // returns 10
    x.indexOf(y, 10);           // returns 10
    x.indexOf(y, 11);           // returns -1

If from is -1, the search starts at the last character; if it is -2, at the next to last character and so on.

See also: lastIndexOf(), contains(), count()

Definition at line 2721 of file qstring.cpp.

 {
     return qFindString(unicode(), length(), from, str.unicode(), str.length(), cs);
 }

◆ indexOf() [3/6]

int QString::indexOf	(	const QLatin1String &	str,
		int	from = `0`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns the index position of the first occurrence of the string str in this string, searching forward from index position from.

Since: 4.5 Returns -1 if str is not found.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

Example:

    QString x = "sticky question";
    QString y = "sti";
    x.indexOf(y);               // returns 0
    x.indexOf(y, 1);            // returns 10
    x.indexOf(y, 10);           // returns 10
    x.indexOf(y, 11);           // returns -1

If from is -1, the search starts at the last character; if it is -2, at the next to last character and so on.

See also: lastIndexOf(), contains(), count()

Definition at line 2748 of file qstring.cpp.

 {
     return qt_find_latin1_string(unicode(), size(), str, from, cs);
 }

◆ indexOf() [4/6]

int QString::indexOf	(	const QStringRef &	s,
		int	from = `0`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 2858 of file qstring.cpp.

 {
     return qFindString(unicode(), length(), from, str.unicode(), str.length(), cs);
 }

◆ indexOf() [5/6]

int QString::indexOf	(	const QRegExp &	rx,
		int	from = `0`
	)		const

Definition at line 3342 of file qstring.cpp.

 {
     QRegExp rx2(rx);
     return rx2.indexIn(*this, from);
 }

◆ indexOf() [6/6]

int QString::indexOf	(	QRegExp &	rx,
		int	from = `0`
	)		const

Definition at line 3366 of file qstring.cpp.

 {
     return rx.indexIn(*this, from);
 }

◆ insert() [1/4]

QString & QString::insert	(	int	i,
		QChar	c
	)

Definition at line 1671 of file qstring.cpp.

 {
     if (i < 0)
         i += d->size;
     if (i < 0)
         return *this;
     expand(qMax(i, d->size));
     ::memmove(d->data + i + 1, d->data + i, (d->size - i) * sizeof(QChar));
     d->data[i] = ch.unicode();
     return *this;
 }

◆ insert() [2/4]

QString & QString::insert	(	int	i,
		const QChar *	uc,
		int	len
	)

Definition at line 1638 of file qstring.cpp.

 {
     if (i < 0 || size <= 0)
         return *this;
 
     const ushort *s = (const ushort *)unicode;
     if (s >= d->data && s < d->data + d->alloc) {
         // Part of me - take a copy
         ushort *tmp = static_cast<ushort *>(qMalloc(size * sizeof(QChar)));
         Q_CHECK_PTR(tmp);
         memcpy(tmp, s, size * sizeof(QChar));
         insert(i, reinterpret_cast<const QChar *>(tmp), size);
         qFree(tmp);
         return *this;
     }
 
     expand(qMax(d->size, i) + size - 1);
 
     ::memmove(d->data + i + size, d->data + i, (d->size - i - size) * sizeof(QChar));
     memcpy(d->data + i, s, size * sizeof(QChar));
     return *this;
 }

◆ insert() [3/4]

QString & QString::insert	(	int	position,
		const QString &	str
	)

inline

Inserts the string str at the given index position and returns a reference to this string.

Example:

    QString str = "Meal";
    str.insert(1, QString("ontr"));
    // str == "Montreal"

If the given position is greater than size(), the array is first extended using resize().

See also: append(), prepend(), replace(), remove()

Definition at line 255 of file qstring.h.

Referenced by insert().

255 { return insert(i, s.constData(), s.length()); }

QString & insert(int i, QChar c)

Definition: qstring.cpp:1671

◆ insert() [4/4]

QString & QString::insert	(	int	i,
		const QLatin1String &	s
	)

Definition at line 1616 of file qstring.cpp.

 {
     const uchar *s = (const uchar *)str.latin1();
     if (i < 0 || !s || !(*s))
         return *this;
 
     int len = qstrlen(str.latin1());
     expand(qMax(d->size, i) + len - 1);
 
     ::memmove(d->data + i + len, d->data + i, (d->size - i - len) * sizeof(QChar));
     for (int j = 0; j < len; ++j)
         d->data[i + j] = s[j];
     return *this;
 }

◆ isDetached()

bool QString::isDetached ( ) const

inline

Warning: This function is not part of the public interface.

Definition at line 716 of file qstring.h.

717 { return d->ref == 1; }

QBasicAtomicInt ref

Definition: qstring.h:604

Data * d

Definition: qstring.h:618

◆ isEmpty()

bool QString::isEmpty ( ) const

inline

Returns true if the string has no characters; otherwise returns false.

Example:

    QString().isEmpty();            // returns true
    QString("").isEmpty();          // returns true
    QString("x").isEmpty();         // returns false
    QString("abc").isEmpty();       // returns false

See also: size()

Definition at line 704 of file qstring.h.

705 { return d->size == 0; }

int size

Definition: qstring.h:605

Referenced by QHttpPrivate::_q_slotSendRequest(), QCoreApplication::applicationDirPath(), QCoreApplication::applicationFilePath(), QPatternist::XQueryTokenizer::attributeAsRaw(), QCss::StyleSelector::basicSelectorMatches(), buildMatchRule(), QWizard::buttonText(), QNetworkAccessAuthenticationManager::cacheProxyCredentials(), QUrlPrivate::canonicalHost(), clear(), QDBusConnectionPrivate::connectSignal(), QSvgIconPlugin::create(), QDomImplementation::createDocumentType(), createUseNode(), QAbstractFileEngineIterator::currentFilePath(), QDBusConnectionPrivate::disconnectSignal(), QTranslatorPrivate::do_translate(), QMotifStyle::drawControl(), QLineEdit::dropEvent(), endsWith(), QStringRef::endsWith(), QPatternist::ReplaceFN::evaluateSingleton(), find_translation(), QSystemTrayIconSys::findTrayGeometry(), QMacPasteboardMime::flavorToMime(), fontExists(), QtFontFamily::foundry(), QUrlPrivate::fragmentImpl(), QWindowsAccessible::get_accValue(), QDBusConnectionPrivate::handleSignal(), QFtpDTP::hasError(), QTextControl::insertFromMimeData(), QComboBox::insertItem(), QPatternist::XSLTTokenizer::insideFunction(), QAxServerBase::Invoke(), QNetworkAuthenticationCredential::isNull(), QStringRef::isNull(), QTranslator::load(), QLibraryInfo::location(), QFtp::login(), QDomNamedNodeMapPrivate::namedItemNS(), QPatternist::XQueryTokenizer::nextToken(), QDBusXmlParser::object(), QMYSQLDriver::open(), QPatternist::AccelTreeResourceLoader::openUnparsedText(), operator!=(), QDirSortItemComparator::operator()(), operator<<(), operator==(), QDeclarativeDirParser::parse(), QXmlStreamReaderPrivate::parse(), QXmlSimpleReaderPrivate::parseBeginOrContinue(), QXmlSimpleReaderPrivate::parseFailed(), QUrl::path(), populate_database(), QDBusConnectionPrivate::prepareHook(), QTextHtmlImporter::processSpecialNodes(), qCreateParamString(), QDomAttrPrivate::QDomAttrPrivate(), QDomElementPrivate::QDomElementPrivate(), qDrawPlainRect(), StringSplitter::qIsForwardIteratorEnd(), qIsForwardIteratorEnd(), qmlxmlhttprequest_open(), QRuntimeGraphicsSystem::QRuntimeGraphicsSystem(), qt_aqua_get_known_size(), qt_get_screen(), qt_init(), QApplicationPrivate::qt_mac_apply_settings(), qt_mac_display_change_callbk(), qt_qFindChild_helper(), qt_qFindChildren_helper(), QTextLayout::QTextLayout(), QWSTslibMouseHandlerPrivate::QWSTslibMouseHandlerPrivate(), QXmlStreamReaderPrivate::raiseError(), QXmlSimpleReaderPrivate::reportParseError(), QDomDocumentTypePrivate::save(), QDomAttrPrivate::save(), QDomElementPrivate::save(), QDomNotationPrivate::save(), QDomEntityPrivate::save(), QFutureWatcherBasePrivate::sendCallOutEvent(), QDomElementPrivate::setAttributeNodeNS(), QUrlPrivate::setAuthority(), QProgressDialog::setCancelButtonText(), QUrl::setFragment(), QSystemTrayIconSys::setIconContents(), QDomNamedNodeMapPrivate::setNamedItemNS(), QXmlNamespaceSupport::setPrefix(), QLabel::setTextFormat(), QWidget::setWindowTitle(), QXmlStreamReaderPrivate::startDocument(), startsWith(), QStringRef::startsWith(), QLineControl::text(), QLocale::toCurrencyString(), QUrlPrivate::toEncoded(), QPatternist::XQueryTokenizer::tokenizeStringLiteral(), toPercentEncodingHelper(), QUrl::toString(), toUtf8(), QStringRef::toUtf8(), QUrlPrivate::userInfo(), QTextOdfWriter::writeBlockFormat(), QXmlStreamWriter::writeProcessingInstruction(), QApplicationPrivate::x11_apply_settings(), and QPSQLResult::~QPSQLResult().

Data * d

Definition: qstring.h:618

◆ isNull()

bool QString::isNull ( ) const

inline

Returns true if this string is null; otherwise returns false.

Example:

    QString().isNull();             // returns true
    QString("").isNull();           // returns false
    QString("abc").isNull();        // returns false

Qt makes a distinction between null strings and empty strings for historical reasons. For most applications, what matters is whether or not a string contains any data, and this can be determined using the isEmpty() function.

See also: isEmpty()

Definition at line 505 of file qstring.h.

505 { return d == &shared_null; }

QString::shared_null

static Data shared_null

Definition: qstring.h:616

Data * d

Definition: qstring.h:618

◆ isRightToLeft()

bool QString::isRightToLeft ( ) const

Returns true if the string is read right to left.

Definition at line 7528 of file qstring.cpp.

Referenced by QDeclarativeTextEditPrivate::determineHorizontalAlignment(), QDeclarativeTextInputPrivate::determineHorizontalAlignment(), QTextEngine::isRightToLeft(), and QLabelPrivate::textDirection().

 {
     return isStringRightToLeft(d->data, d->data + d->size);
 }

◆ isSharedWith()

bool QString::isSharedWith ( const QString & other ) const

inline

Warning: This function is not part of the public interface.

Definition at line 123 of file qstring.h.

123 { return d == other.d; }

QString::updateProperties

Data * d

Definition: qstring.h:618

◆ isSimpleText()

bool QString::isSimpleText ( ) const

inline

Warning: This function is not part of the public interface.

Definition at line 588 of file qstring.h.

588 { if (!d->clean) updateProperties(); return d->simpletext; }

void updateProperties() const

Definition: qstring.cpp:7510

QString::Data::clean

ushort clean

Definition: qstring.h:607

QString::Data::simpletext

Data * d

Definition: qstring.h:618

ushort simpletext

Definition: qstring.h:608

◆ lastIndexOf() [1/6]

int QString::lastIndexOf	(	QChar	c,
		int	from = `-1`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3000 of file qstring.cpp.

Referenced by _q_parseDosDir(), QFileDialogPrivate::_q_updateOkButton(), QDeclarativeImportsPrivate::add(), QFileDialogPrivate::addDefaultSuffixToFiles(), addTag(), QCoreApplicationPrivate::appendApplicationPathToLibraryPaths(), QFileDialogPrivate::basename(), QDeclarativeCompiler::buildDynamicMeta(), createImageNode(), QDeclarativeComponentPrivate::createObject(), customMimeType(), QKeySequencePrivate::decodeString(), QDeclarativeXmlQueryEngine::doQueryJob(), DumpIDL(), fbname(), QFileInfoGatherer::fetchExtendedInformation(), QResourceFileEngine::fileName(), fileName(), QDeclarativeImportedNamespace::find(), find_translation(), QSslCertificate::fromPath(), QFileSystemEngine::getLinkTarget(), QSymSQLResultPrivate::initColumns(), QAxBase::initializeRemote(), isDirPath(), QSslSocketBackendPrivate::isMatchingHostname(), keyName(), keyPath(), lastIndexOf(), QByteArray::lastIndexOf(), QStringRef::lastIndexOf(), launchWebBrowser(), QTranslator::load(), QAxServerBase::Load(), QFSFileEnginePrivate::longFileName(), menuItemEntry(), QDeclarativeEngineDebugService::objectData(), QScriptNewBreakpointWidget::onOkClicked(), QStringRef::operator=(), parseFontName(), parseIp6(), qAxInit(), qt_init(), qt_is_idn_enabled(), QFileDialogPrivate::qt_mac_filedialog_filter_proc(), qt_mac_menu_merge_action(), qt_set_x11_resources(), qt_setWindowTitle_helperHelper(), MetaObjectGenerator::readClassInfo(), QFileSystemEngine::removeDirectory(), QDeclarativeImportsPrivate::resolvedUri(), QAxServerBase::Save(), QNetworkCookieJar::setCookiesFromUrl(), QDeclarativeFolderListModel::setFolder(), QDesktopServices::storageLocation(), QMenuPrivate::QMacMenuPrivate::syncAction(), QFileInfoGatherer::updateFile(), UpdateRegistry(), QAxFactory::validateLicenseKey(), and QDeclarativeInfo::~QDeclarativeInfo().

 {
     return qt_last_index_of(unicode(), size(), ch, from, cs);
     }

◆ lastIndexOf() [2/6]

int QString::lastIndexOf	(	const QString &	str,
		int	from = `-1`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns the index position of the last occurrence of the string str in this string, searching backward from index position from.

If from is -1 (default), the search starts at the last character; if from is -2, at the next to last character and so on. Returns -1 if str is not found.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

Example:

    QString x = "crazy azimuths";
    QString y = "az";
    x.lastIndexOf(y);           // returns 6
    x.lastIndexOf(y, 6);        // returns 6
    x.lastIndexOf(y, 5);        // returns 2
    x.lastIndexOf(y, 1);        // returns -1

See also: indexOf(), contains(), count()

Definition at line 2925 of file qstring.cpp.

 {
     const int sl = str.d->size;
     if (sl == 1)
         return lastIndexOf(QChar(str.d->data[0]), from, cs);
 
     const int l = d->size;
     if (from < 0)
         from += l;
     int delta = l-sl;
     if (from == l && sl == 0)
         return from;
     if (from < 0 || from >= l || delta < 0)
         return -1;
     if (from > delta)
         from = delta;
 
     return lastIndexOfHelper(d->data, from, str.d->data, str.d->size, cs);
 }

◆ lastIndexOf() [3/6]

int QString::lastIndexOf	(	const QLatin1String &	s,
		int	from = `-1`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 2967 of file qstring.cpp.

 {
     const int sl = qstrlen(str.latin1());
     if (sl == 1)
         return lastIndexOf(QLatin1Char(str.latin1()[0]), from, cs);
 
     const int l = d->size;
     if (from < 0)
         from += l;
     int delta = l-sl;
     if (from == l && sl == 0)
         return from;
     if (from < 0 || from >= l || delta < 0)
         return -1;
     if (from > delta)
         from = delta;
 
     QVarLengthArray<ushort> s(sl);
     for (int i = 0; i < sl; ++i)
         s[i] = str.latin1()[i];
 
     return lastIndexOfHelper(d->data, from, s.data(), sl, cs);
 }

◆ lastIndexOf() [4/6]

int QString::lastIndexOf	(	const QStringRef &	s,
		int	from = `-1`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3023 of file qstring.cpp.

 {
     const int sl = str.size();
     if (sl == 1)
         return lastIndexOf(str.at(0), from, cs);
 
     const int l = d->size;
     if (from < 0)
         from += l;
     int delta = l - sl;
     if (from == l && sl == 0)
         return from;
     if (from < 0 || from >= l || delta < 0)
     return -1;
     if (from > delta)
         from = delta;
 
     return lastIndexOfHelper(d->data, from, reinterpret_cast<const ushort*>(str.unicode()),
                              str.size(), cs);
 }

◆ lastIndexOf() [5/6]

int QString::lastIndexOf	(	const QRegExp &	rx,
		int	from = `-1`
	)		const

Definition at line 3385 of file qstring.cpp.

 {
     QRegExp rx2(rx);
     return rx2.lastIndexIn(*this, from);
 }

◆ lastIndexOf() [6/6]

int QString::lastIndexOf	(	QRegExp &	rx,
		int	from = `-1`
	)		const

Definition at line 3409 of file qstring.cpp.

 {
     return rx.lastIndexIn(*this, from);
 }

◆ left()

QString QString::left ( int n ) const

Returns a substring that contains the n leftmost characters of the string.

The entire string is returned if n is greater than size() or less than zero.

QString x = "Pineapple";

QString y = x.left(4); // y == "Pine"

See also: right(), mid(), startsWith()

Definition at line 3664 of file qstring.cpp.

 {
     if (n >= d->size || n < 0)
         return *this;
     return QString((const QChar*) d->data, n);
 }

◆ leftJustified()

QString QString::leftJustified	(	int	width,
		QChar	fill = `QLatin1Char(' ')`,
		bool	truncate = `false`
	)		const

Returns a string of size width that contains this string padded by the fill character.

If truncate is false and the size() of the string is more than width, then the returned string is a copy of the string.

QString s = "apple";

QString t = s.leftJustified(8, '.'); // t == "apple..."

If truncate is true and the size() of the string is more than width, then any characters in a copy of the string after position width are removed, and the copy is returned.

QString str = "Pineapple";

str = str.leftJustified(5, '.', true); // str == "Pinea"

See also: rightJustified()

Definition at line 5318 of file qstring.cpp.

Referenced by QPatternist::AbstractDuration::create(), QPatternist::AbstractDateTime::create(), and vsprintf().

 {
     QString result;
     int len = length();
     int padlen = width - len;
     if (padlen > 0) {
         result.resize(len+padlen);
         if (len)
             memcpy(result.d->data, d->data, sizeof(QChar)*len);
         QChar *uc = (QChar*)result.d->data + len;
         while (padlen--)
            * uc++ = fill;
     } else {
         if (truncate)
             result = left(width);
         else
             result = *this;
     }
     return result;
 }

◆ leftRef()

QStringRef QString::leftRef ( int n ) const

Returns a substring reference to the n leftmost characters of the string.

Since: 4.4

If n is greater than size() or less than zero, a reference to the entire string is returned.

QString x = "Pineapple";

QStringRef y = x.leftRef(4); // y == "Pine"

See also: left(), rightRef(), midRef(), startsWith()

Definition at line 9045 of file qstring.cpp.

Referenced by QDeclarativePropertyCache::create(), QSslSocketBackendPrivate::isMatchingHostname(), and parseServerList().

 {
     if (n >= d->size || n < 0)
         n = d->size;
     return QStringRef(this, 0, n);
 }

◆ length()

int QString::length ( ) const

inline

Returns the number of characters in this string.

Equivalent to size().

See also: resize()

Definition at line 696 of file qstring.h.

Referenced by QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QPrintDialogPrivate::_q_printerOrFileSelected(), QHttpPrivate::_q_slotConnected(), QFileDialogPrivate::_q_updateOkButton(), QDeclarativeTypeLoader::absoluteFilePath(), QFileDialog::accept(), QDBusConnectionPrivate::activateObject(), QDeclarativeImportDatabase::addImportPath(), QDeclarativeImportDatabase::addPluginPath(), QDir::addResourceSearchPath(), addTag(), QTextHtmlImporter::appendNodeText(), QConcatenable< QString >::appendTo(), QSyntaxHighlighterPrivate::applyFormatChanges(), QUnixPrintWidgetPrivate::applyPrinterProperties(), QKeySequence::assign(), QPatternist::DerivedString< TypeToken >::attributeNormalize(), QTextEngine::attributes(), QFileSystemEntry::baseName(), bidiItemize(), QOCIResultPrivate::bindValue(), QFontMetrics::boundingRect(), QFontMetricsF::boundingRect(), QPainter::boundingRect(), QDeclarativeCompiler::buildDynamicMeta(), QTextCodec::canEncode(), canonicalOrderHelper(), QRegExpEngine::Box::cat(), QFontMetrics::charWidth(), QPatternist::XsdTypeChecker::checkConstrainingFacetsString(), QDir::cleanPath(), QLineControl::clear(), QLocalePrivate::codeToCountry(), QLocalePrivate::codeToLanguage(), QLocalePrivate::codeToScript(), QDeclarativeStringConverters::colorFromString(), compare(), QStringRef::compare(), QLineControl::complete(), QFileSystemEntry::completeBaseName(), QDeclarativeCompiler::completeComponentBuild(), QScriptCompletionTaskPrivate::completeScriptExpression(), QScriptDebuggerConsoleCommandManager::completions(), composeHelper(), QWinInputContext::composition(), computeElidedText(), QLinuxFbScreen::connect(), QAbstractConcatenable::convertFromAscii(), QWindowsMimeText::convertFromMime(), QWindowsMimeURI::convertFromMime(), QBuiltInMimes::convertFromMime(), Qt::convertFromPlainText(), QWindowsMimeURI::convertToMime(), QUtf8::convertToUnicode(), count(), QNetworkAccessFileBackendFactory::create(), QFileSystemEngine::createDirectory(), createFileFromTemplate(), QPatternist::URILoader::createRequest(), QPSQLResult::data(), QDomCharacterDataPrivate::dataLength(), QLocalePrivate::dateTimeToString(), decimalForm(), QKeySequencePrivate::decodeString(), decomposeHelper(), QPatternist::CompressedWhitespace::decompress(), QDeclarativeListModelParser::definesEmptyList(), derefEngine(), double2string(), QLocalePrivate::doubleToString(), QDragManager::drag(), QSvgText::draw(), QPainter::drawText(), QLineEdit::dropEvent(), DumpIDL(), QAxBase::dynamicCallHelper(), QTextEngine::elidedText(), QTextHtmlExporter::emitFragment(), QTextHtmlExporter::emitFrameStyle(), encodeText(), QStringRef::endsWith(), QPatternist::CaseInsensitiveStringComparator::equals(), errorCodeToString(), Qt::escape(), QPatternist::escape(), escapedKey(), QPatternist::AtomicString::evaluateEBV(), QPatternist::DerivedString< TypeToken >::evaluateEBV(), QPatternist::TranslateFN::evaluateSingleton(), QCalendarTextNavigator::eventFilter(), QRegExp::exactMatch(), QDB2Result::exec(), QODBCResult::exec(), QSqlResult::exec(), QOCICols::execBatch(), QProcessPrivate::execChild(), exponentForm(), extractEncodingDecl(), familyList(), QWSSoundServerPrivate::feedDevice(), QFileSystemEntry::fileName(), QDir::filePath(), QFileSystemModelPrivate::filePath(), QShortcutMap::find(), findArgEscapes(), findChildObject(), findGraphicsFactory(), findGroupFactory(), findInBlock(), QResourceRoot::findNode(), findObject(), findStyleFactoryMethod(), findStyleUtilFactoryMethod(), QSystemTrayIconSys::findTrayGeometry(), findUtilFactory(), fmtDateTime(), QTextEngine::formatIndex(), QTest::formatResult(), QSqlDriver::formatValue(), QPatternist::NamePool::fromClarkName(), QPatternist::HexBinary::fromLexical(), QUrl::fromLocalFile(), QDir::fromNativeSeparators(), QUrl::fromPunycode(), QDateTime::fromString(), QTextCodec::fromUnicode(), QTextEncoder::fromUnicode(), generateName(), QAxServerBase::GetCurFile(), getEnglishName(), getMessage(), getNextChar(), QGtkStylePrivate::getThemeName(), QMacInputContext::globalEventProcessor(), QApplicationPrivate::globalEventProcessor(), QRegExpEngine::goodStringMatch(), QDBusConnectionPrivate::handleSignal(), QLineControl::hasAcceptableInput(), QDeclarativeXMLHttpRequest::headers(), QRegExpEngine::heuristicallyChooseHeuristic(), QScriptSyntaxHighlighter::highlightBlock(), QCalendarDateSectionValidator::highlightString(), QScriptSyntaxHighlighter::highlightWord(), QTextDocumentLayout::hitTest(), QUrl::host(), QRegExp::indexIn(), indexOf(), QStringRef::indexOf(), QFontMetrics::inFontUcs4(), QFontMetricsF::inFontUcs4(), QSettingsPrivate::iniEscapedKey(), QDeclarativeTextInputPrivate::init(), QSQLite2ResultPrivate::init(), QLineControl::init(), QAxBase::initializeRemote(), QSettingsPrivate::iniUnescapedKey(), QTextControlPrivate::inputMethodEvent(), QTextDocumentPrivate::insert(), QTextDocumentPrivate::insertBlock(), QTextCursor::insertText(), int2string(), QLineControl::internalDelete(), QLineControl::internalInsert(), QLCDNumberPrivate::internalSetString(), QLineControl::internalSetText(), QAxServerBase::Invoke(), QFileSystemEntry::isAbsolute(), QKeyMapperPrivate::isADeadKey(), isDirPath(), QFileSystemEntry::isDriveRoot(), QPatternist::LangFN::isLangMatch(), QSslSocketBackendPrivate::isMatchingHostname(), QUrl::isParentOf(), isPrefixOf(), QXmlUtils::isPublicID(), QFileSystemEntry::isRelative(), isSignalPropertyName(), isSupportedSvgFeature(), isUncRoot(), QDBusUtil::isValidBusName(), QDBusUtil::isValidInterfaceName(), QDBusUtil::isValidMemberName(), QPatternist::DerivedString< TypeToken >::isValidName(), QPatternist::DerivedString< TypeToken >::isValidNMTOKEN(), QDBusUtil::isValidPartOfObjectPath(), QDBusUtil::isValidUniqueConnectionName(), QTextEngine::itemize(), QTextEngine::justify(), QTest::keyClicks(), QMenuBar::keyPressEvent(), QMenu::keyPressEvent(), QTextEdit::keyPressEvent(), QRegExp::lastIndexIn(), launchWebBrowser(), QTextLine::layout_helper(), QTextEngine::LayoutData::LayoutData(), leftJustified(), QPatternist::ProcessingInstructionConstructor::leftTrimmed(), CharacterData::length(), lengthLessThan(), QCss::ValueExtractor::lengthValue(), QTextEngine::lineNumberForTextPosition(), QTranslator::load(), QAxServerBase::Load(), loadEngine(), localeAwareCompare(), QStringRef::localeAwareCompare(), localizedName(), longestCommonPrefix(), QFSFileEnginePrivate::longFileName(), QLocalePrivate::longLongToString(), QPatternist::XQueryTokenizer::lookupKeyword(), QLineControl::maskString(), menuItemEntry(), Qt::mightBeRichText(), QMacPasteboardMimeAny::mimeFor(), QKeySequence::mnemonic(), QMacInputContext::mouseHandler(), QWinInputContext::mouseHandler(), QXIMInputContext::mouseHandler(), QDeclarativeTextInput::moveCursorSelection(), QFileSystemEngine::nativeAbsoluteFilePath(), QFileSystemModelPrivate::naturalCompare(), QTextHtmlParser::newNode(), QScriptEnginePrivate::newRegExp(), QCssScanner_Generated::next(), nextDotDelimiter(), QTextEngine::nextLogicalPosition(), QPatternist::XQueryTokenizer::nextToken(), QFileSystemModelPrivate::node(), QStyleSheetStyleSelector::nodeNameEquals(), QLocalePrivate::numberToCLocale(), QScriptNewBreakpointWidget::onOkClicked(), QOCIDriver::open(), QDB2Driver::open(), QAudioInputPrivate::open(), QODBCDriver::open(), QAudioOutputPrivate::open(), QTemporaryFileEngine::open(), operator<(), operator<<(), QGraphicsSimpleTextItem::paint(), QDeclarativeStyledTextPrivate::parse(), QDeclarativeDirParser::parse(), QDeclarativeJS::Parser::parse(), QTextHtmlParser::parse(), parse_locale_tag(), QSvgHandler::parseCSStoXMLAttrs(), QTextHtmlParser::parseEntity(), QPatternist::PatternPlatform::parseFlags(), parseFontName(), QLineControl::parseInputMask(), QHttpResponseHeader::parseLine(), QHttpRequestHeader::parseLine(), QDeclarativeBindingCompilerPrivate::parseName(), parseServerList(), QXmlSimpleReaderPrivate::parseString(), QFileSystemEntry::path(), QFSCompleter::pathFromIndex(), populate_database(), QDeclarativeTextEdit::positionAt(), QDB2Result::prepare(), QOCIResult::prepare(), QODBCResult::prepare(), QDBusConnectionPrivate::prepareHook(), QDB2Driver::primaryIndex(), QODBCDriver::primaryIndex(), QLineControl::processInputMethodEvent(), QLineControl::processKeyEvent(), QXmlSimpleReaderPrivate::processReference(), QFtpPI::processReply(), QProcessPrivate::processStarted(), QDeclarativeTextInput::q_canPasteChanged(), qDateTimeFromString(), qDBusGenerateMetaObjectXml(), qDBusInterfaceFromMetaObject(), QDeclarative_isFileCaseCorrect(), QDeclarativeImportDatabase::QDeclarativeImportDatabase(), qEncodeNtlmString(), QLineEdit::QLineEdit(), QRegExpEngine::QRegExpEngine(), qReplacePlaceholderMarkers(), qSplitTableAndOwner(), qStreamNtlmString(), qStringAsUcs2Le(), QtPrivate::QStringList_contains(), QStringToBSTR(), QStringToOLESTR(), qt_accAmpIndex(), qt_ACE_do(), qt_create_commandline(), qt_format_text(), qt_keyrelease_scanner(), QFileDialogPrivate::qt_mac_filedialog_event_proc(), QFileDialogPrivate::qt_mac_filedialog_filter_proc(), qt_mac_menu_merge_action(), qt_mac_removeMnemonics(), qt_mac_to_pascal_string(), qt_parsePrintcap(), qt_parsePrinterDesc(), qt_parsePrintersConf(), qt_parseQconfig(), qt_parseSpoolInterface(), qt_section_chunk::qt_section_chunk(), qt_set_x11_resources(), qt_splitLocaleName(), qt_string_normalize(), qt_tildeExpansion(), qt_win_get_open_file_names(), qt_win_make_OFN(), qTextAfterOffsetFromString(), qTextAtOffsetFromString(), qTextBeforeOffsetFromString(), QUuid::QUuid(), qWinCmdArgs(), qwsSetClipboardText(), QTextStreamPrivate::read(), QWinSettingsPrivate::readKey(), QVFbScreenKeyboardHandler::readKeyboardData(), QFtpPI::readyRead(), QDB2Driver::record(), QODBCDriver::record(), QPSQLDriver::record(), QTextControlPrivate::rectForPosition(), QDeclarativeBindingCompilerPrivate::registerLiteralString(), QFileSystemEngine::removeDirectory(), QLineControl::removeSelectedText(), replace(), replaceArgEscapes(), replacePercentN(), QDeclarativeXMLHttpRequest::requestFromUrl(), QDB2Result::reset(), QODBCResult::reset(), QDeclarativeImportsPrivate::resolvedUri(), resolveScheme(), QDeclarativeCompiler::rewriteBinding(), rightJustified(), QAxServerBase::Save(), section(), QLineEdit::selectionStart(), QKeyMapper::sendKeyEvent(), QLineEditPrivate::sendMouseEventToInputContext(), QTextControlPrivate::sendMouseEventToInputContext(), QWSInputMethod::sendPreeditString(), QWSServerPrivate::sendQCopEvent(), QWinSettingsPrivate::set(), set_text(), QCoreApplication::setApplicationVersion(), QUrlPrivate::setAuthority(), QTextEngine::setBoundary(), QWSQCopRegisterChannelCommand::setChannel(), QScript::Lexer::setCode(), QDeclarativeJS::Lexer::setCode(), QColor::setColorFromString(), QBBInputContext::setComposingText(), QAxBase::setControl(), QPluginLoader::setFileName(), QWSPlaySoundCommand::setFileName(), QSystemTrayIconSys::setIconContents(), QWSIdentifyCommand::setId(), QTextLine::setLineWidth(), QWSQCopSendCommand::setMessage(), QDeclarativeTextInput::setPasswordCharacter(), QDirPrivate::setPath(), QLineControl::setSelection(), QGtkStylePrivate::setupGtkFileChooser(), QUrlPrivate::setUserInfo(), QSystemTrayIconSys::showMessage(), QNmDBusHelper::slotAccessPointAdded(), QNmDBusHelper::slotAccessPointRemoved(), QSettingsPrivate::splitArgs(), splitSpaceSemicolon(), QSqlDriver::sqlStatement(), QScriptCompletionTask::start(), QFtpPI::startNextCmd(), QTextBoundaryFinder::string(), stringContainsNullChar(), QSettingsPrivate::stringListToVariantList(), QLineControl::stripString(), stripTextDecl(), QMenuPrivate::QMacMenuPrivate::syncAction(), QDB2Driver::tables(), QODBCDriver::tables(), QFontMetrics::tightBoundingRect(), QFontMetricsF::tightBoundingRect(), toAscii(), QStringRef::toAscii(), QFileDialogPrivate::toInternal(), QPatternist::Tokenizer::tokenToString(), toLatin1(), QStringRef::toLatin1(), QProcessEnvironmentPrivate::toList(), QStringRef::toLocal8Bit(), QUrl::toLocalFile(), QDir::toNativeSeparators(), toPunycodeHelper(), toStdWString(), QKeySequence::toString(), totalDigitsForDecimal(), totalDigitsForSignedLongLong(), totalDigitsForUnsignedLongLong(), XsdSchemaToken::toToken(), QPatternist::XSLTTokenLookup::toToken(), toUcs4(), QStringRef::toUcs4(), toUcs4_helper(), QFontEngineXLFD::toUnicode(), toUtf8(), QStringRef::toUtf8(), toWCharArray(), QETWidget::translateKeyEvent(), QXlibKeyboard::translateKeySym(), QXcbKeyboard::translateKeySym(), translateKeySym(), QWSSoundServerClient::tryReadCommand(), typeNameToXml(), QLocalePrivate::unsLongLongToString(), QLineControl::updateDisplayText(), QFileInfoGatherer::updateFile(), QPrintPreviewDialogPrivate::updatePageNumLabel(), UpdateRegistry(), QSpinBoxValidator::validate(), QLocalePrivate::validateChars(), vsprintf(), wc2rx(), QFontMetrics::width(), QFontMetricsF::width(), QXmlSerializer::write(), write_xbm_image(), QTextOdfWriter::writeBlock(), QXmlSerializer::writeEscaped(), QXmlSerializer::writeEscapedAttribute(), QApplication::x11ProcessEvent(), and xic_draw_callback().

697 { return d->size; }

int size

Definition: qstring.h:605

QString::localeAwareCompare

Data * d

Definition: qstring.h:618

◆ localeAwareCompare() [1/4]

int QString::localeAwareCompare ( const QString & s ) const

Definition at line 5197 of file qstring.cpp.

Referenced by QStringRef::at(), QSortFilterProxyModel::lessThan(), localeAwareCompare(), QFileSystemModelPrivate::naturalCompare(), QDirSortItemComparator::operator()(), and QAbstractItemModelPrivate::variantLessThan().

 {
     return localeAwareCompare_helper(constData(), length(), other.constData(), other.length());
 }

◆ localeAwareCompare() [2/4]

int QString::localeAwareCompare	(	const QString &	s1,
		const QString &	s2
	)

inlinestatic

Compares s1 with s2 and returns an integer less than, equal to, or greater than zero if s1 is less than, equal to, or greater than s2.

The comparison is performed in a locale- and also platform-dependent manner. Use this function to present sorted lists of strings to the user.

On Mac OS X since Qt 4.3, this function compares according the "Order for sorted lists" setting in the International prefereces panel.

See also: compare(), QTextCodec::locale()

Definition at line 367 of file qstring.h.

368 { return s1.localeAwareCompare(s2); }

int localeAwareCompare(const QString &s) const

Definition: qstring.cpp:5197

◆ localeAwareCompare() [3/4]

int QString::localeAwareCompare ( const QStringRef & s ) const

inline

Definition at line 1262 of file qstring.h.

1263 { return localeAwareCompare_helper(constData(), length(), s.constData(), s.length()); }

QString::localeAwareCompare_helper

static int localeAwareCompare_helper(const QChar *data1, int length1, const QChar *data2, int length2)

Definition: qstring.cpp:5212

int length() const

Returns the number of characters referred to by the string reference.

Definition: qstring.h:1116

int length() const

Returns the number of characters in this string.

Definition: qstring.h:696

const QChar * constData() const

Same as unicode().

Definition: qstring.h:1159

QString::localeAwareCompare_helper

const QChar * constData() const

Returns a pointer to the data stored in the QString.

Definition: qstring.h:712

◆ localeAwareCompare() [4/4]

int QString::localeAwareCompare	(	const QString &	s1,
		const QStringRef &	s2
	)

inlinestatic

Definition at line 1264 of file qstring.h.

1265 { return localeAwareCompare_helper(s1.constData(), s1.length(), s2.constData(), s2.length()); }

static int localeAwareCompare_helper(const QChar *data1, int length1, const QChar *data2, int length2)

Definition: qstring.cpp:5212

int length() const

Returns the number of characters referred to by the string reference.

Definition: qstring.h:1116

int length() const

Returns the number of characters in this string.

Definition: qstring.h:696

const QChar * constData() const

Same as unicode().

Definition: qstring.h:1159

Referenced by QFileDialogPrivate::_q_createDirectory(), QFtpPrivate::_q_startNextCommand(), QNetworkManagerEngine::activationFinished(), QNetworkManagerEngine::activeConnectionPropertiesChanged(), QFontDatabasePrivate::addAppFont(), addressFromSockaddr(), QConnmanEngine::addServiceConfiguration(), QDeclarativeParser::Variant::asScript(), QAccessibleTextWidget::attributes(), QUrlPrivate::authority(), breakpointMapToScriptValue(), QPatternist::XsdTypeChecker::checkConstrainingFacetsSignedInteger(), QPatternist::XsdTypeChecker::checkConstrainingFacetsUnsignedInteger(), QCoreApplicationPrivate::checkReceiverThread(), classIDL(), QGraphicsWidget::close(), QPdfBaseEnginePrivate::closePrintDevice(), QDeclarativeStateGroup::componentComplete(), QNetworkManagerEngine::connectionFromId(), QFtp::connectToHost(), QCoreWlanEngine::connectToId(), QDeclarativeBindingCompilerPrivate::contextName(), convert(), QWindowsMimeHtml::convertFromMime(), QAxServerBase::create(), QPatternist::AbstractDateTime::create(), QDeclarativeEnginePrivate::createCache(), QUrlPrivate::createErrorString(), createForMib(), decodeMSG(), QPatternist::Expression::description(), QNetworkManagerEngine::disconnectFromId(), QPatternist::Cardinality::displayName(), QGenericEngine::doRequestUpdate(), QMacStylePrivate::drawColorlessButton(), QGtkStyle::drawComplexControl(), QPlastiqueStyle::drawControl(), QCleanlooksStyle::drawControl(), QGtkStyle::drawPrimitive(), QDeclarativeCompiledData::dump(), QGridLayoutEngine::dump(), QPatternist::XsdSchemaDebugger::dumpParticle(), QTextHtmlExporter::emitBlock(), QTextHtmlExporter::emitBlockAttributes(), QTextHtmlExporter::emitCharFormatStyle(), QTextHtmlExporter::emitFragment(), QTextHtmlExporter::emitFrameStyle(), QTextHtmlExporter::emitTable(), QTextHtmlExporter::emitTextFrame(), QTextHtmlExporter::emitTextLength(), encodeText(), QtopiaPrintEngine::end(), QDeclarativeComponent::errorString(), QEgl::errorString(), QPatternist::GenerateIDFN::evaluateSingleton(), QPatternist::CodepointsToStringFN::evaluateSingleton(), QScriptEdit::extraAreaPaintEvent(), QWSSoundServerPrivate::feedDevice(), QXmlStreamWriterPrivate::findNamespace(), QPatternist::formatData(), QTest::formatResult(), QDB2Driver::formatValue(), QSqlDriver::formatValue(), QIBaseDriver::formatValue(), QOCIDriver::formatValue(), QODBCDriver::formatValue(), QPSQLDriver::formatValue(), QPatternist::HexBinary::fromLexical(), QHostInfoAgent::fromName(), QDeclarativeRectangle::generateBorderedRect(), QDeclarativeRectangle::generateRoundedRect(), getFmtString(), QNetworkManagerEngine::getInterfaceFromId(), QScanThread::getSsidFromNetworkName(), QGestureManager::getState(), getValue(), QPatternist::ColoringMessageHandler::handleMessage(), QNetworkManagerEngine::hasIdentifier(), QTreeModel::headerData(), QColorDialogPrivate::init(), QTreeModel::insertColumns(), QTextCursor::insertImage(), QNetworkManagerEngine::interfacePropertiesChanged(), QLibraryPrivate::isPlugin(), QTextList::itemText(), QTextCodecPlugin::keys(), loadSingleEngine(), QScriptDebuggerConsoleWidget::message(), QScriptDebugOutputWidget::message(), QScriptStdMessageHandler::message(), QProgressBar::minimumSizeHint(), QCalendarWidget::minimumSizeHint(), multiArg(), QNetworkManagerEngine::newAccessPoint(), QDeclarativeJS::numberToString(), object_name_for_button(), QDB2Driver::open(), QPSQLDriver::open(), QDebug::operator<<(), QSqlRelationalTableModel::orderByClause(), QStaticTextPrivate::paintText(), QNetworkManagerEngine::parseConnection(), QNlaThread::parseQuerySet(), pixelToPoint(), QSvgIconEnginePrivate::pmcKey(), QNetworkDiskCachePrivate::prepareLayout(), QDB2Driver::primaryIndex(), QODBCDriver::primaryIndex(), printPage(), QPatternist::AccelTree::printStats(), QFtp::put(), qDBusNewConnection(), QFontEngineQPF::QFontEngineQPF(), QSvgPaintEngine::qfontToSvg(), qMakePreparedStmtId(), QSvgPaintEngine::qpenToSvg(), qReplacePlaceholderMarkers(), QScriptDebuggerBackendPrivate::qsassert(), qt_create_internal_window(), qt_mac_constructQIconFromIconRef(), qt_reg_winclass(), qt_socket_getPortAndAddress(), QDB2Driver::record(), QODBCDriver::record(), registerFont(), QNetworkManagerEngine::removeAccessPoint(), QNetworkManagerEngine::removeConnection(), resolveGdi32(), QPatternist::SystemPropertyFN::retrieveProperty(), QDoubleSpinBoxPrivate::round(), QScanThread::run(), runningUnderDebugger(), QNativeWifiEngine::scanComplete(), scriptMapToScriptValue(), QDateTimeParser::sectionName(), QWSSoundServerClient::sendDeviceError(), QWSSoundServerClient::sendDeviceReady(), QWSSoundServerClient::sendSoundCompleted(), QConnmanEngine::serviceFromId(), QConnmanEngine::servicePropertyChangedContext(), QNetworkManagerEngine::sessionStateForId(), QNetworkDiskCache::setCacheDirectory(), QTreeModel::setColumnCount(), QHttpHeader::setContentLength(), QLibrary::setFileNameAndVersion(), QFtp::setProxy(), QIBaseResult::size(), sm_performSaveYourself(), QHttpPGHRequest::start(), QFtpPI::startNextCmd(), QCoreWlanEngine::startTime(), QDateTimeParser::stateName(), QPatternist::YearMonthDuration::stringValue(), QPatternist::Duration::stringValue(), QPatternist::Integer::stringValue(), QPatternist::DayTimeDuration::stringValue(), QPatternist::AbstractFloat< isDouble >::stringValue(), QPatternist::DerivedInteger< DerivedType >::stringValue(), QDB2Driver::tables(), QODBCDriver::tables(), QCalendarDayValidator::text(), QAccessibleDisplay::text(), QAccessibleItemRow::text(), QAccessibleScrollBar::text(), QAccessibleSlider::text(), QAccessibleDial::text(), QCalendarMonthValidator::text(), QCalendarYearValidator::text(), QUrlPrivate::toEncoded(), QTextHtmlExporter::toHtml(), QDeclarativeError::toString(), QScriptContext::toString(), QEglProperties::toString(), QDate::toString(), QScriptDebuggerValue::toString(), QTest::toString(), QSettingsGroup::toString(), QPatternist::Decimal::toString(), QDeclarativeObjectScriptClass::tostring(), QDateTime::toString(), QFont::toString(), toString(), totalDigitsForSignedLongLong(), totalDigitsForUnsignedLongLong(), translate_color(), QNetworkDiskCachePrivate::uniqueFileName(), QNetworkManagerEngine::updateAccessPoint(), QPrintPreviewDialogPrivate::updateNavActions(), QCalendarWidgetPrivate::updateNavigationBar(), QPrintPreviewDialogPrivate::updatePageNumLabel(), UpdateRegistry(), QFontDialogPrivate::updateSizes(), variantToString(), QSettingsPrivate::variantToString(), WinMain(), QTextOdfWriter::writeBlock(), QTextOdfWriter::writeCharacterFormat(), QTextOdfWriter::writeFrame(), QTextOdfWriter::writeListFormat(), QX11EmbedWidget::x11Event(), QPatternist::AbstractDateTime::zoneOffsetToString(), QColorDialog::~QColorDialog(), QDB2Result::~QDB2Result(), QEventDispatcherWin32Private::~QEventDispatcherWin32Private(), and QODBCResult::~QODBCResult().

const QChar * constData() const

Returns a pointer to the data stored in the QString.

Definition: qstring.h:712

◆ localeAwareCompare_helper()

int QString::localeAwareCompare_helper	(	const QChar *	data1,
		int	length1,
		const QChar *	data2,
		int	length2
	)

staticprivate

Warning: This function is not part of the public interface.

Since: 4.5

Definition at line 5212 of file qstring.cpp.

Referenced by localeAwareCompare(), and QStringRef::localeAwareCompare().

 {
     // do the right thing for null and empty
     if (length1 == 0 || length2 == 0)
         return ucstrcmp(data1, length1, data2, length2);
 
 #if defined(Q_OS_WIN32) || defined(Q_OS_WINCE)
     int res = CompareString(GetUserDefaultLCID(), 0, (wchar_t*)data1, length1, (wchar_t*)data2, length2);
 
     switch (res) {
     case CSTR_LESS_THAN:
         return -1;
     case CSTR_GREATER_THAN:
         return 1;
     default:
         return 0;
     }
 #elif defined (Q_OS_MAC)
     // Use CFStringCompare for comparing strings on Mac. This makes Qt order
     // strings the same way as native applications do, and also respects
     // the "Order for sorted lists" setting in the International preferences
     // panel.
     const CFStringRef thisString =
         CFStringCreateWithCharactersNoCopy(kCFAllocatorDefault,
             reinterpret_cast<const UniChar *>(data1), length1, kCFAllocatorNull);
     const CFStringRef otherString =
         CFStringCreateWithCharactersNoCopy(kCFAllocatorDefault,
             reinterpret_cast<const UniChar *>(data2), length2, kCFAllocatorNull);
 
     const int result = CFStringCompare(thisString, otherString, kCFCompareLocalized);
     CFRelease(thisString);
     CFRelease(otherString);
     return result;
 #elif defined(Q_OS_SYMBIAN)
     TPtrC p1 = TPtrC16(reinterpret_cast<const TUint16 *>(data1), length1);
     TPtrC p2 = TPtrC16(reinterpret_cast<const TUint16 *>(data2), length2);
     return p1.CompareC(p2);
 #elif defined(Q_OS_UNIX)
 #  if defined(QT_USE_ICU)
     int res;
     if (qt_ucol_strcoll(data1, length1, data2, length2, &res)) {
         if (res == 0)
             res = ucstrcmp(data1, length1, data2, length2);
         return res;
     } // else fall through
 #  endif
     // declared in <string.h>
     int delta = strcoll(toLocal8Bit_helper(data1, length1), toLocal8Bit_helper(data2, length2));
     if (delta == 0)
         delta = ucstrcmp(data1, length1, data2, length2);
     return delta;
 #else
     return ucstrcmp(data1, length1, data2, length2);
 #endif
 }

◆ mid()

QString QString::mid	(	int	position,
		int	n = `-1`
	)		const

Returns a string that contains n characters of this string, starting at the specified position index.

Returns a null string if the position index exceeds the length of the string. If there are less than n characters available in the string starting at the given position, or if n is -1 (default), the function returns all characters that are available from the specified position.

Example:

    QString x = "Nine pineapples";
    QString y = x.mid(5, 4);            // y == "pine"
    QString z = x.mid(5);               // z == "pineapples"

See also: left(), right()

Definition at line 3706 of file qstring.cpp.

 {
     if (d == &shared_null || position >= d->size)
         return QString();
     if (n < 0)
         n = d->size - position;
     if (position < 0) {
         n += position;
         position = 0;
     }
     if (n + position > d->size)
         n = d->size - position;
     if (position == 0 && n == d->size)
         return *this;
     return QString((const QChar*) d->data + position, n);
 }

◆ midRef()

QStringRef QString::midRef	(	int	position,
		int	n = `-1`
	)		const

Returns a substring reference to n characters of this string, starting at the specified position.

Since: 4.4

If the position exceeds the length of the string, an empty reference is returned.

If there are less than n characters available in the string, starting at the given position, or if n is -1 (default), the function returns all characters from the specified position onwards.

Example:

    QString x = "Nine pineapples";
    QStringRef y = x.midRef(5, 4);      // y == "pine"
    QStringRef z = x.midRef(5);         // z == "pineapples"

See also: mid(), leftRef(), rightRef()

Definition at line 9099 of file qstring.cpp.

Referenced by QSslSocketBackendPrivate::isMatchingHostname(), and parseServerList().

 {
     if (d == &shared_null || position >= d->size)
         return QStringRef();
     if (n < 0)
         n = d->size - position;
     if (position < 0) {
         n += position;
         position = 0;
     }
     if (n + position > d->size)
         n = d->size - position;
     return QStringRef(this, position, n);
 }

◆ multiArg()

QString QString::multiArg	(	int	numArgs,
		const QString **	args
	)		const

private

Definition at line 7434 of file qstring.cpp.

Referenced by arg().

 {
     QString result;
     QMap<int, int> numbersUsed;
     const QChar *uc = (const QChar *) d->data;
     const int len = d->size;
     const int end = len - 1;
     int lastNumber = -1;
     int i = 0;
 
     // populate the numbersUsed map with the %n's that actually occur in the string
     while (i < end) {
         if (uc[i] == QLatin1Char('%')) {
             int number = getEscape(uc, &i, len);
             if (number != -1) {
                 numbersUsed.insert(number, -1);
                 continue;
             }
         }
         ++i;
     }
 
     // assign an argument number to each of the %n's
     QMap<int, int>::iterator j = numbersUsed.begin();
     QMap<int, int>::iterator jend = numbersUsed.end();
     int arg = 0;
     while (j != jend && arg < numArgs) {
         *j = arg++;
         lastNumber = j.key();
         ++j;
     }
 
     // sanity
     if (numArgs > arg) {
         qWarning("QString::arg: %d argument(s) missing in %s", numArgs - arg, toLocal8Bit().data());
         numArgs = arg;
     }
 
     i = 0;
     while (i < len) {
         if (uc[i] == QLatin1Char('%') && i != end) {
             int number = getEscape(uc, &i, len, lastNumber);
             int arg = numbersUsed[number];
             if (number != -1 && arg != -1) {
                 result += *args[arg];
                 continue;
             }
         }
         result += uc[i++];
     }
     return result;
 }

◆ normalized() [1/2]

QString QString::normalized ( QString::NormalizationForm mode ) const

Returns the string in the given Unicode normalization mode.

Definition at line 6635 of file qstring.cpp.

Referenced by QMacPasteboardMimeFileUri::convertFromMime(), QMacPasteboardMimeUrl::convertFromMime(), QMacPasteboardMimeFileUri::convertToMime(), QMacPasteboardMimeUrl::convertToMime(), getFullPath(), locale_decode(), and locale_encode().

 {
     return normalized(mode, UNICODE_DATA_VERSION);
 }

◆ normalized() [2/2]

QString QString::normalized	(	QString::NormalizationForm	mode,
		QChar::UnicodeVersion	version
	)		const

Returns the string in the given Unicode normalization mode, according to the given version of the Unicode standard.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6703 of file qstring.cpp.

 {
     QString copy = *this;
     qt_string_normalize(&copy, mode, version, 0);
     return copy;
 }

◆ number() [1/7]

QString QString::number	(	int	n,
		int	base = `10`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6448 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, base);
     return s;
 }

◆ number() [2/7]

QString QString::number	(	uint	n,
		int	base = `10`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6458 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, base);
     return s;
 }

◆ number() [3/7]

QString QString::number	(	long	n,
		int	base = `10`
	)

static

Returns a string equivalent of the number n according to the specified base.

The base is 10 by default and must be between 2 and 36. For bases other than 10, n is treated as an unsigned integer.

    long a = 63;
    QString s = QString::number(a, 16);             // s == "3f"
    QString t = QString::number(a, 16).toUpper();     // t == "3F"

See also: setNum()

Definition at line 6426 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, base);
     return s;
 }

◆ number() [4/7]

QString QString::number	(	ulong	n,
		int	base = `10`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6438 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, base);
     return s;
 }

◆ number() [5/7]

QString QString::number	(	qlonglong	n,
		int	base = `10`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6468 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, base);
     return s;
 }

◆ number() [6/7]

QString QString::number	(	qulonglong	n,
		int	base = `10`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6478 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, base);
     return s;
 }

◆ number() [7/7]

QString QString::number	(	double	n,
		char	format = `'g'`,
		int	precision = `6`
	)

static

Returns a string equivalent of the number n, formatted according to the specified format and precision.

See Argument Formats for details.

Unlike QLocale::toString(), this function does not honor the user's locale settings.

See also: setNum(), QLocale::toString()

Definition at line 6501 of file qstring.cpp.

 {
     QString s;
     s.setNum(n, f, prec);
     return s;
 }

◆ operator!=() [1/4]

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

inline

Returns true if this string is not equal to string other; otherwise returns false.

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings with localeAwareCompare().

Definition at line 406 of file qstring.h.

406 { return !operator==(s); }

QString::operator==

bool operator==(const QString &s) const

Returns true if string other is equal to this string; otherwise returns false.

Definition: qstring.cpp:2368

◆ operator!=() [2/4]

bool QString::operator!= ( const QLatin1String & s ) const

inline

Definition at line 413 of file qstring.h.

413 { return !operator==(s); }

QString::operator==

bool operator==(const QString &s) const

Returns true if string other is equal to this string; otherwise returns false.

Definition: qstring.cpp:2368

◆ operator!=() [3/4]

bool QString::operator!= ( const char * s ) const

inline

Definition at line 925 of file qstring.h.

926 { return !qStringComparisonHelper(*this, s); }

friend bool qStringComparisonHelper(const QString &s1, const char *s2)

Definition: qstring.h:916

◆ operator!=() [4/4]

bool QString::operator!= ( const QByteArray & s ) const

inline

Definition at line 978 of file qstring.h.

979 { return !qStringComparisonHelper(*this, s.constData()); }

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

friend bool qStringComparisonHelper(const QString &s1, const char *s2)

Definition: qstring.h:916

◆ operator+=() [1/8]

QString& QString::operator+= ( QChar c )

inline

Definition at line 265 of file qstring.h.

Referenced by QByteArray::operator+=().

                                         {
         if (d->ref != 1 || d->size + 1 > d->alloc)
             realloc(grow(d->size + 1));
         d->data[d->size++] = c.unicode();
         d->data[d->size] = '\0';
         return *this;
     }

◆ operator+=() [2/8]

QString& QString::operator+= ( QChar::SpecialCharacter c )

inline

Definition at line 273 of file qstring.h.

273 { return append(QChar(c)); }

unsigned char c[8]

Definition: qnumeric_p.h:62

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ operator+=() [3/8]

QString & QString::operator+= ( const QString & other )

inline

Appends the string other onto the end of this string and returns a reference to this string.

Example:

    QString x = "free";
    QString y = "dom";
    x += y;
    // x == "freedom"

This operation is typically very fast (constant time), because QString preallocates extra space at the end of the string data so it can grow without reallocating the entire string each time.

See also: append(), prepend()

Definition at line 274 of file qstring.h.

274 { return append(s); }

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ operator+=() [4/8]

QString& QString::operator+= ( const QStringRef & s )

inline

Definition at line 275 of file qstring.h.

275 { return append(s); }

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ operator+=() [5/8]

QString& QString::operator+= ( const QLatin1String & s )

inline

Definition at line 276 of file qstring.h.

276 { return append(s); }

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ operator+=() [6/8]

QT_ASCII_CAST_WARN QString& QString::operator+= ( const char * s )

inline

Definition at line 440 of file qstring.h.

441 { return append(QString::fromAscii(s)); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ operator+=() [7/8]

QT_ASCII_CAST_WARN QString& QString::operator+= ( const QByteArray & s )

inline

Definition at line 442 of file qstring.h.

443 { return append(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

QString & append(QChar c)

Definition: qstring.cpp:1777

uint qstrnlen(const char *str, uint maxlen)

Definition: qbytearray.h:82

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ operator+=() [8/8]

QT_ASCII_CAST_WARN QString& QString::operator+= ( char c )

inline

Definition at line 444 of file qstring.h.

445 { return append(QChar::fromAscii(c)); }

unsigned char c[8]

Definition: qnumeric_p.h:62

QString & append(QChar c)

Definition: qstring.cpp:1777

static QChar fromAscii(char c)

Converts the ASCII character c to its equivalent QChar.

Definition: qchar.cpp:1521

◆ operator<() [1/4]

bool QString::operator< ( const QString & other ) const

Returns true if this string is lexically less than string other; otherwise returns false.

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings using the QString::localeAwareCompare() function.

Definition at line 2436 of file qstring.cpp.

 {
     return ucstrcmp(constData(), length(), other.constData(), other.length()) < 0;
 }

◆ operator<() [2/4]

bool QString::operator< ( const QLatin1String & s ) const

Definition at line 2444 of file qstring.cpp.

 {
     const ushort *uc = d->data;
     const ushort *e = uc + d->size;
     const uchar *c = (uchar *) other.latin1();
 
     if (!c || *c == 0)
         return false;
 
     while (*c) {
         if (uc == e || *uc != *c)
             break;
         ++uc;
         ++c;
     }
     return (uc == e ? *c : *uc < *c);
 }

◆ operator<() [3/4]

bool QString::operator< ( const char * s ) const

inline

Definition at line 927 of file qstring.h.

928 { return *this < QString::fromAscii(s); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator<() [4/4]

QT_ASCII_CAST_WARN bool QString::operator< ( const QByteArray & s ) const

inline

Definition at line 456 of file qstring.h.

457 { return *this < QString::fromAscii(s.constData(), s.size()); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ operator<=() [1/4]

bool QString::operator<= ( const QString & other ) const

inline

Returns true if this string is lexically less than or equal to string other; otherwise returns false.

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings with localeAwareCompare().

Definition at line 407 of file qstring.h.

407 { return !operator>(s); }

QString::operator>

bool operator>(const QString &s) const

Returns true if this string is lexically greater than string other; otherwise returns false...

Definition: qstring.h:405

◆ operator<=() [2/4]

bool QString::operator<= ( const QLatin1String & s ) const

inline

Definition at line 414 of file qstring.h.

414 { return !operator>(s); }

QString::operator>

bool operator>(const QString &s) const

Returns true if this string is lexically greater than string other; otherwise returns false...

Definition: qstring.h:405

◆ operator<=() [3/4]

bool QString::operator<= ( const char * s2 ) const

inline

Definition at line 931 of file qstring.h.

932 { return *this <= QString::fromAscii(s); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator<=() [4/4]

QT_ASCII_CAST_WARN bool QString::operator<= ( const QByteArray & s ) const

inline

Definition at line 460 of file qstring.h.

461 { return *this <= QString::fromAscii(s.constData(), s.size()); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ operator=() [1/7]

QString & QString::operator= ( QChar c )

Definition at line 1582 of file qstring.cpp.

Referenced by append(), QDBusObjectPath::operator=(), QDBusSignature::operator=(), QCharRef::operator=(), QStringRef::operator=(), QSettingsKey::originalKeyPosition(), QDBusObjectPath::QDBusObjectPath(), QDBusObjectPath::setPath(), and QDBusSignature::setSignature().

 {
     return operator=(QString(ch));
 }

◆ operator=() [2/7]

QString & QString::operator= ( const QString & other )

Assigns other to this string and returns a reference to this string.

Definition at line 1508 of file qstring.cpp.

 {
     other.d->ref.ref();
     if (!d->ref.deref())
         QString::free(d);
     d = other.d;
     return *this;
 }

◆ operator=() [3/7]

QString & QString::operator= ( const QLatin1String & s )

inline

Definition at line 718 of file qstring.h.

 {
     *this = fromLatin1(s.latin1());
     return *this;
 }

◆ operator=() [4/7]

QT_ASCII_CAST_WARN QString& QString::operator= ( const char * ch )

inline

Definition at line 424 of file qstring.h.

425 { return (*this = fromAscii(ch)); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator=() [5/7]

QT_ASCII_CAST_WARN QString& QString::operator= ( const QByteArray & a )

inline

Definition at line 426 of file qstring.h.

427 { return (*this = fromAscii(a.constData(), qstrnlen(a.constData(), a.size()))); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

uint qstrnlen(const char *str, uint maxlen)

Definition: qbytearray.h:82

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ operator=() [6/7]

QT_ASCII_CAST_WARN QString& QString::operator= ( char c )

inline

Definition at line 428 of file qstring.h.

429 { return (*this = QChar::fromAscii(c)); }

unsigned char c[8]

Definition: qnumeric_p.h:62

static QChar fromAscii(char c)

Converts the ASCII character c to its equivalent QChar.

Definition: qchar.cpp:1521

◆ operator=() [7/7]

QString & QString::operator= ( const Null & )

inline

Warning: This function is not part of the public interface.

Definition at line 504 of file qstring.h.

504 { *this = QString(); return *this; }

QString()

Constructs a null string.

Definition: qstring.h:879

◆ operator==() [1/4]

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

Returns true if string other is equal to this string; otherwise returns false.

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings with localeAwareCompare().

Definition at line 2368 of file qstring.cpp.

 {
     if (d->size != other.d->size)
         return false;
 
     return qMemEquals(d->data, other.d->data, d->size);
 }

◆ operator==() [2/4]

bool QString::operator== ( const QLatin1String & s ) const

Definition at line 2379 of file qstring.cpp.

 {
     const ushort *uc = d->data;
     const ushort *e = uc + d->size;
     const uchar *c = (uchar *)other.latin1();
 
     if (!c)
         return isEmpty();
 
     while (*c) {
         if (uc == e || *uc != *c)
             return false;
         ++uc;
         ++c;
     }
     return (uc == e);
 }

◆ operator==() [3/4]

bool QString::operator== ( const char * s ) const

inline

Definition at line 923 of file qstring.h.

924 { return qStringComparisonHelper(*this, s); }

friend bool qStringComparisonHelper(const QString &s1, const char *s2)

Definition: qstring.h:916

◆ operator==() [4/4]

bool QString::operator== ( const QByteArray & s ) const

inline

Definition at line 976 of file qstring.h.

977 { return qStringComparisonHelper(*this, s.constData()); }

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

friend bool qStringComparisonHelper(const QString &s1, const char *s2)

Definition: qstring.h:916

◆ operator>() [1/4]

bool QString::operator> ( const QString & other ) const

inline

Returns true if this string is lexically greater than string other; otherwise returns false.

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings with localeAwareCompare().

Definition at line 405 of file qstring.h.

405 { return s < *this; }

◆ operator>() [2/4]

bool QString::operator> ( const QLatin1String & s ) const

Definition at line 2558 of file qstring.cpp.

 {
     const ushort *uc = d->data;;
     const ushort *e = uc + d->size;
     const uchar *c = (uchar *) other.latin1();
 
     if (!c || *c == '\0')
         return !isEmpty();
 
     while (*c) {
         if (uc == e || *uc != *c)
             break;
         ++uc;
         ++c;
     }
     return (uc == e ? false : *uc > *c);
 }

◆ operator>() [3/4]

bool QString::operator> ( const char * s2 ) const

inline

Definition at line 929 of file qstring.h.

930 { return *this > QString::fromAscii(s); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator>() [4/4]

QT_ASCII_CAST_WARN bool QString::operator> ( const QByteArray & s ) const

inline

Definition at line 458 of file qstring.h.

459 { return *this > QString::fromAscii(s.constData(), s.size()); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ operator>=() [1/4]

bool QString::operator>= ( const QString & other ) const

inline

Returns true if this string is lexically greater than or equal to string other; otherwise returns false.

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings with localeAwareCompare().

Definition at line 408 of file qstring.h.

408 { return !operator<(s); }

QString::operator<

bool operator<(const QString &s) const

Returns true if this string is lexically less than string other; otherwise returns false...

Definition: qstring.cpp:2436

◆ operator>=() [2/4]

bool QString::operator>= ( const QLatin1String & s ) const

inline

Definition at line 415 of file qstring.h.

415 { return !operator<(s); }

QString::operator<

bool operator<(const QString &s) const

Returns true if this string is lexically less than string other; otherwise returns false...

Definition: qstring.cpp:2436

◆ operator>=() [3/4]

bool QString::operator>= ( const char * s2 ) const

inline

Definition at line 933 of file qstring.h.

934 { return *this >= QString::fromAscii(s); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator>=() [4/4]

QT_ASCII_CAST_WARN bool QString::operator>= ( const QByteArray & s ) const

inline

Definition at line 462 of file qstring.h.

463 { return *this >= QString::fromAscii(s.constData(), s.size()); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ operator[]() [1/4]

const QChar QString::operator[] ( int i ) const

inline

Definition at line 700 of file qstring.h.

701 { Q_ASSERT(uint(i) < uint(size())); return d->data[i]; }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

QString::size

int size() const

Returns the number of characters in this string.

Definition: qstring.h:102

uint

unsigned int uint

Definition: qglobal.h:996

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ operator[]() [2/4]

QCharRef QString::operator[] ( int position )

inline

Returns the character at the specified position in the string as a modifiable reference.

Example:

    QString str;
    if (str[0] == QChar('?'))
        str[0] = QChar('_');

The return value is of type QCharRef, a helper class for QString. When you get an object of type QCharRef, you can use it as if it were a QChar &. If you assign to it, the assignment will apply to the character in the QString from which you got the reference.

See also: at()

Definition at line 884 of file qstring.h.

885 { Q_ASSERT(i >= 0); return QCharRef(*this, i); }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

QString::QCharRef

friend class QCharRef

Definition: qstring.h:641

◆ operator[]() [3/4]

const QChar QString::operator[] ( uint i ) const

inline

Definition at line 702 of file qstring.h.

703 { Q_ASSERT(i < uint(size())); return d->data[i]; }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

QString::size

int size() const

Returns the number of characters in this string.

Definition: qstring.h:102

uint

unsigned int uint

Definition: qglobal.h:996

Data * d

Definition: qstring.h:618

ushort * data

Definition: qstring.h:606

◆ operator[]() [4/4]

QCharRef QString::operator[] ( uint i )

inline

Definition at line 886 of file qstring.h.

887 { return QCharRef(*this, i); }

QString::QCharRef

friend class QCharRef

Definition: qstring.h:641

◆ prepend() [1/5]

QString& QString::prepend ( QChar c )

inline

Definition at line 261 of file qstring.h.

261 { return insert(0, c); }

QString & insert(int i, QChar c)

Definition: qstring.cpp:1671

◆ prepend() [2/5]

QString & QString::prepend ( const QString & str )

inline

Prepends the string str to the beginning of this string and returns a reference to this string.

Example:

    QString x = "ship";
    QString y = "air";
    x.prepend(y);
    // x == "airship"

See also: append(), insert()

Definition at line 262 of file qstring.h.

262 { return insert(0, s); }

QString & insert(int i, QChar c)

Definition: qstring.cpp:1671

◆ prepend() [3/5]

QString& QString::prepend ( const QLatin1String & s )

inline

Definition at line 263 of file qstring.h.

263 { return insert(0, s); }

QString & insert(int i, QChar c)

Definition: qstring.cpp:1671

◆ prepend() [4/5]

QT_ASCII_CAST_WARN QString& QString::prepend ( const char * s )

inline

Definition at line 432 of file qstring.h.

433 { return prepend(QString::fromAscii(s)); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

QString & prepend(QChar c)

Definition: qstring.h:261

◆ prepend() [5/5]

QT_ASCII_CAST_WARN QString& QString::prepend ( const QByteArray & s )

inline

Definition at line 434 of file qstring.h.

435 { return prepend(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

QString & prepend(QChar c)

Definition: qstring.h:261

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

uint qstrnlen(const char *str, uint maxlen)

Definition: qbytearray.h:82

int size() const

Returns the number of bytes in this byte array.

Definition: qbytearray.h:402

◆ push_back() [1/2]

void QString::push_back ( QChar ch )

inline

Appends the given ch character onto the end of this string.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 481 of file qstring.h.

481 { append(c); }

unsigned char c[8]

Definition: qnumeric_p.h:62

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ push_back() [2/2]

void QString::push_back ( const QString & other )

inline

This function is provided for STL compatibility, appending the given other string onto the end of this string.

It is equivalent to append(other).

See also: append()

Definition at line 482 of file qstring.h.

482 { append(s); }

QString & append(QChar c)

Definition: qstring.cpp:1777

◆ push_front() [1/2]

void QString::push_front ( QChar ch )

inline

Prepends the given ch character to the beginning of this string.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 483 of file qstring.h.

483 { prepend(c); }

unsigned char c[8]

Definition: qnumeric_p.h:62

QString & prepend(QChar c)

Definition: qstring.h:261

◆ push_front() [2/2]

void QString::push_front ( const QString & other )

inline

This function is provided for STL compatibility, prepending the given other string to the beginning of this string.

It is equivalent to prepend(other).

See also: prepend()

Definition at line 484 of file qstring.h.

484 { prepend(s); }

Referenced by QScriptDebuggerLocalsWidgetPrivate::_q_onCompletionTaskFinished(), QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QPrintPreviewDialogPrivate::_q_zoomFactorChanged(), cleanPath(), composeHelper(), QTextStreamPrivate::consume(), QScriptDebuggerConsole::consumeInput(), createUseNode(), QKeySequencePrivate::decodeString(), QDomCharacterDataPrivate::deleteData(), QAccessibleSimpleEditableTextInterface::deleteText(), elliditide(), filterDisplayOffset(), filterTransformation(), fixedCDataSection(), fixedComment(), fixedPIData(), fixedPubidLiteral(), fixedSystemLiteral(), QSpinBox::fixup(), QDoubleSpinBox::fixup(), QTest::formatResult(), QPatternist::DerivedInteger< DerivedType >::fromLexical(), QGtkStylePrivate::getThemeName(), QMessageBoxPrivate::hideSpecial(), QSQLiteResultPrivate::initColumns(), QLineControl::internalDelete(), QLineControl::internalRedo(), QLineControl::internalUndo(), QXmlSimpleReaderPrivate::isExpandedEntityValueTooLarge(), QFSFileEnginePrivate::longFileName(), QWSServerPrivate::newMouseHandler(), QSettingsPrivate::normalizedKey(), QAxClientSite::OnPosRectChange(), QSQLiteDriver::open(), QTest::outputMessage(), QTextHtmlParser::parseEntity(), QCss::Parser::parseSimpleSelector(), QCss::Parser::parseTerm(), qExtractSecurityPolicyFromString(), qt_accStripAmp(), qt_mac_menu_merge_action(), qt_parseSpoolInterface(), qt_setWindowTitle_helperHelper(), qt_strippedText(), qt_tildeExpansion(), qt_wce_insert_action(), qt_wce_rename_menu_item(), qt_win_get_open_file_name(), qt_win_get_open_file_names(), qt_win_get_save_file_name(), qt_win_make_OFN(), readLink(), QDir::relativeFilePath(), removeOptionalQuotes(), QLineControl::removeSelectedText(), QFileSystemEntry::resolveFilePath(), QFileDialog::selectFile(), QNetworkCookieJar::setCookiesFromUrl(), QPluginLoader::setFileName(), QSvgNode::styleProperty(), QStyleSheetStyle::styleRules(), QMenuPrivate::QMacMenuPrivate::syncAction(), QSpinBox::textFromValue(), QDoubleSpinBox::textFromValue(), QmlJSDebugger::AbstractLiveEditTool::titleForItem(), QSystemLocalePrivate::toCurrencyString(), QUrl::toLocalFile(), QCss::Parser::unquotedLexem(), QSpinBoxPrivate::validateAndInterpret(), QDoubleSpinBoxPrivate::validateAndInterpret(), and xic_draw_callback().

QString & prepend(QChar c)

Definition: qstring.h:261

◆ realloc() [1/2]

void QString::realloc ( )

private

Definition at line 1472 of file qstring.cpp.

Referenced by append(), detach(), replace(), reserve(), resize(), and utf16().

 {
     realloc(d->size);
 }

◆ realloc() [2/2]

void QString::realloc ( int alloc )

private

Definition at line 1437 of file qstring.cpp.

 {
     if (d->ref != 1 || d->data != d->array) {
         Data *x = static_cast<Data *>(qMalloc(sizeof(Data) + alloc * sizeof(QChar)));
         Q_CHECK_PTR(x);
         x->size = qMin(alloc, d->size);
         ::memcpy(x->array, d->data, x->size * sizeof(QChar));
         x->array[x->size] = 0;
         x->asciiCache = 0;
         x->ref = 1;
         x->alloc = alloc;
         x->clean = d->clean;
         x->simpletext = d->simpletext;
         x->righttoleft = d->righttoleft;
         x->capacity = d->capacity;
         x->data = x->array;
         if (!d->ref.deref())
             QString::free(d);
         d = x;
     } else {
 #ifdef QT3_SUPPORT
         if (d->asciiCache) {
             QMutexLocker locker(asciiCacheMutex());
             Q_ASSERT(asciiCache);
             asciiCache->remove(d);
         }
 #endif
         Data *p = static_cast<Data *>(qRealloc(d, sizeof(Data) + alloc * sizeof(QChar)));
         Q_CHECK_PTR(p);
         d = p;
         d->alloc = alloc;
         d->data = d->array;
     }
 }

◆ remove() [1/4]

QString & QString::remove	(	int	position,
		int	n
	)

Removes n characters from the string, starting at the given position index, and returns a reference to the string.

If the specified position index is within the string, but position + n is beyond the end of the string, the string is truncated at the specified position.

    QString s = "Montreal";
    s.remove(1, 4);
    // s == "Meal"

See also: insert(), replace()

Definition at line 1867 of file qstring.cpp.

 {
     if (pos < 0)  // count from end of string
         pos += d->size;
     if (pos < 0 || pos >= d->size) {
         // range problems
     } else if (len >= d->size - pos) {
         resize(pos); // truncate
     } else if (len > 0) {
         detach();
         memmove(d->data + pos, d->data + pos + len,
                 (d->size - pos - len + 1) * sizeof(ushort));
         d->size -= len;
     }
     return *this;
 }

◆ remove() [2/4]

QString & QString::remove	(	QChar	ch,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Removes every occurrence of the character ch in this string, and returns a reference to this string.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

Example:

    QString t = "Ali Baba";
    t.remove(QChar('a'), Qt::CaseInsensitive);
    // t == "li Bb"

This is the same as replace(ch, "", cs).

See also: replace()

Definition at line 1920 of file qstring.cpp.

 {
     int i = 0;
     ushort c = ch.unicode();
     if (cs == Qt::CaseSensitive) {
         while (i < d->size)
             if (d->data[i] == ch)
                 remove(i, 1);
             else
                 i++;
     } else {
         c = foldCase(c);
         while (i < d->size)
             if (foldCase(d->data[i]) == c)
                 remove(i, 1);
             else
                 i++;
     }
     return *this;
 }

◆ remove() [3/4]

QString & QString::remove	(	const QString &	str,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Removes every occurrence of the given str string in this string, and returns a reference to this string.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

This is the same as replace(str, "", cs).

See also: replace()

Definition at line 1895 of file qstring.cpp.

 {
     if (str.d->size) {
         int i = 0;
         while ((i = indexOf(str, i, cs)) != -1)
             remove(i, str.d->size);
     }
     return *this;
 }

◆ remove() [4/4]

QString & QString::remove ( const QRegExp & rx )

inline

Removes every occurrence of the regular expression rx in the string, and returns a reference to the string.

For example:

    QString r = "Telephone";
    r.remove(QRegExp("[aeiou]."));
    // r == "The"

See also: indexOf(), lastIndexOf(), replace()

Definition at line 295 of file qstring.h.

296 { return replace(rx, QString()); }

QString::replace

QString & replace(int i, int len, QChar after)

Definition: qstring.cpp:2005

Referenced by _q_escapeIdentifier(), QUnixPrintWidgetPrivate::_q_printerChanged(), QFileDialogPrivate::_q_useNameFilter(), QDeclarativeImportsPrivate::add(), QDeclarativeImportDatabase::addImportPath(), QStyleSheetStyleSelector::attribute(), QAccessibleTextWidget::attributes(), QDir::cleanPath(), QDateTimeEditPrivate::clearSection(), comify(), QWindowsMimeText::convertToMime(), createSvgNode(), QScriptDebuggerLocalsModel::data(), decomposeHelper(), QSvgText::draw(), QTextHtmlExporter::emitBlock(), encodeText(), QDeclarativeDirParser::errors(), QDB2Driver::escapeIdentifier(), QIBaseDriver::escapeIdentifier(), QOCIDriver::escapeIdentifier(), QSQLite2Driver::escapeIdentifier(), QTDSDriver::escapeIdentifier(), QMYSQLDriver::escapeIdentifier(), QPSQLDriver::escapeIdentifier(), QODBCDriver::escapeIdentifier(), QPatternist::ReplaceFN::evaluateSingleton(), QSqlResult::exec(), find_translation(), findInBlock(), QMacPasteboardMimeAny::flavorFor(), QTextStreamPrivate::flushWriteBuffer(), QSqlDriver::formatValue(), QMYSQLDriver::formatValue(), QPSQLDriver::formatValue(), QBBSystemLocaleData::getCorrectFormat(), QComboMenuDelegate::getStyleOption(), QApplicationPrivate::globalEventProcessor(), QSvgSwitch::init(), QXmlSimpleReaderPrivate::insertXmlRef(), QLineControl::internalDelete(), QLineControl::internalInsert(), launchWebBrowser(), QAxServerBase::Load(), QLibraryInfo::location(), QFSFileEnginePrivate::longFileName(), QSharedMemoryPrivate::makePlatformSafeKey(), mapToLowerCase(), QProgressBar::minimumSizeHint(), QPatternist::XsdTypeChecker::normalizedValue(), QPSQLDriver::open(), QSplitter::operator>>(), QGraphicsSimpleTextItem::paint(), QDateTimeParser::parse(), QPatternist::PatternPlatform::parsePattern(), QDateTimeParser::parseSection(), QProcessPrivate::pipeWriterBytesToWrite(), QHttpNetworkConnectionPrivate::prepareRequest(), QCss::Scanner::preprocess(), qDBusGenerateMetaObjectXml(), qDBusInterfaceFromMetaObject(), QDeclarativeScriptEngine::QDeclarativeScriptEngine(), QFontEngineQPF::QFontEngineQPF(), qQuote(), qt_accStripAmp(), qt_create_commandline(), qt_mac_extract_filter(), qt_mac_menu_merge_action(), qt_setWindowTitle_helperHelper(), qt_tildeExpansion(), qt_win_get_existing_directory(), quoteNewline(), readSymLink(), QLineControl::removeSelectedText(), QByteArray::replace(), replace(), QDomCharacterDataPrivate::replaceData(), replacePercentN(), QAccessibleSimpleEditableTextInterface::replaceText(), QDeclarativeXMLHttpRequest::requestFromUrl(), QDeclarativeImportsPrivate::resolvedUri(), QDeclarativeTypeData::resolveTypes(), QAxServerBase::Save(), QAction::setText(), QUrl::setUrl(), QDesktopServices::storageLocation(), stripTextDecl(), tabTextFor(), QAccessibleMdiSubWindow::text(), QGraphicsSimpleTextItemPrivate::updateBoundingRect(), QMdiSubWindowPrivate::updateInternalWindowTitle(), QDeclarativeTextPrivate::updateLayout(), QFontDialogPrivate::updateStyles(), WinMain(), QDBusMetaObjectGenerator::write(), QXmlStreamWriter::writeCDATA(), and xic_draw_callback().

QString()

Constructs a null string.

Definition: qstring.h:879

◆ repeated()

QString QString::repeated ( int times ) const

Returns a copy of this string repeated the specified number of times.

Since: 4.5

If times is less than 1, an empty string is returned.

Example:

QString str("ab");

str.repeated(4); // returns "abababab"

Definition at line 6657 of file qstring.cpp.

 {
     if (d->size == 0)
         return *this;
 
     if (times <= 1) {
         if (times == 1)
             return *this;
         return QString();
     }
 
     const int resultSize = times * d->size;
 
     QString result;
     result.reserve(resultSize);
     if (result.d->alloc != resultSize)
         return QString(); // not enough memory
 
     memcpy(result.d->data, d->data, d->size * sizeof(ushort));
 
     int sizeSoFar = d->size;
     ushort *end = result.d->data + sizeSoFar;
 
     const int halfResultSize = resultSize >> 1;
     while (sizeSoFar <= halfResultSize) {
         memcpy(end, result.d->data, sizeSoFar * sizeof(ushort));
         end += sizeSoFar;
         sizeSoFar <<= 1;
     }
     memcpy(end, result.d->data, (resultSize - sizeSoFar) * sizeof(ushort));
     result.d->data[resultSize] = '\0';
     result.d->size = resultSize;
     return result;
 }

◆ replace() [1/12]

QString & QString::replace	(	int	i,
		int	len,
		QChar	after
	)

Definition at line 2005 of file qstring.cpp.

 {
     return replace(pos, len, &after, 1);
 }

◆ replace() [2/12]

QString & QString::replace	(	int	i,
		int	len,
		const QChar *	s,
		int	slen
	)

Definition at line 1983 of file qstring.cpp.

 {
     if (pos < 0 || pos > d->size)
         return *this;
     if (pos + len > d->size)
         len = d->size - pos;
 
     uint index = pos;
     replace_helper(&index, 1, len, unicode, size);
     return *this;
 }

◆ replace() [3/12]

QString & QString::replace	(	int	position,
		int	n,
		const QString &	after
	)

Replaces n characters beginning at index position with the string after and returns a reference to this string.

Example:

    QString x = "Say yes!";
    QString y = "no";
    x.replace(4, 3, y);
    // x == "Say no!"

See also: insert(), remove()

Definition at line 1970 of file qstring.cpp.

 {
     QString copy = after;
     return replace(pos, len, copy.constData(), copy.length());
 }

◆ replace() [4/12]

QString & QString::replace	(	QChar	before,
		QChar	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2230 of file qstring.cpp.

 {
     ushort a = after.unicode();
     ushort b = before.unicode();
     if (d->size) {
         detach();
         ushort *i = d->data;
         const ushort *e = i + d->size;
         if (cs == Qt::CaseSensitive) {
             for (; i != e; ++i)
                 if (*i == b)
                     *i = a;
         } else {
             b = foldCase(b);
             for (; i != e; ++i)
                 if (foldCase(*i) == b)
                     *i = a;
         }
     }
     return *this;
 }

◆ replace() [5/12]

QString & QString::replace	(	const QChar *	before,
		int	blen,
		const QChar *	after,
		int	alen,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2121 of file qstring.cpp.

 {
     if (d->size == 0) {
         if (blen)
             return *this;
     } else {
         if (cs == Qt::CaseSensitive && before == after && blen == alen)
             return *this;
     }
     if (alen == 0 && blen == 0)
         return *this;
 
     QStringMatcher matcher(before, blen, cs);
 
     int index = 0;
     while (1) {
         uint indices[1024];
         uint pos = 0;
         while (pos < 1023) {
             index = matcher.indexIn(*this, index);
             if (index == -1)
                 break;
             indices[pos++] = index;
             index += blen;
             // avoid infinite loop
             if (!blen)
                 index++;
         }
         if (!pos)
             break;
 
         replace_helper(indices, pos, blen, after, alen);
 
         if (index == -1)
             break;
         // index has to be adjusted in case we get back into the loop above.
         index += pos*(alen-blen);
     }
 
     return *this;
 }

◆ replace() [6/12]

QString & QString::replace	(	const QLatin1String &	before,
		const QLatin1String &	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2267 of file qstring.cpp.

 {
     int alen = qstrlen(after.latin1());
     QVarLengthArray<ushort> a(alen);
     for (int i = 0; i < alen; ++i)
         a[i] = (uchar)after.latin1()[i];
     int blen = qstrlen(before.latin1());
     QVarLengthArray<ushort> b(blen);
     for (int i = 0; i < blen; ++i)
         b[i] = (uchar)before.latin1()[i];
     return replace((const QChar *)b.data(), blen, (const QChar *)a.data(), alen, cs);
 }

◆ replace() [7/12]

QString & QString::replace	(	const QLatin1String &	before,
		const QString &	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2297 of file qstring.cpp.

 {
     int blen = qstrlen(before.latin1());
     QVarLengthArray<ushort> b(blen);
     for (int i = 0; i < blen; ++i)
         b[i] = (uchar)before.latin1()[i];
     return replace((const QChar *)b.data(), blen, after.constData(), after.d->size, cs);
 }

◆ replace() [8/12]

QString & QString::replace	(	const QString &	before,
		const QLatin1String &	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2323 of file qstring.cpp.

 {
     int alen = qstrlen(after.latin1());
     QVarLengthArray<ushort> a(alen);
     for (int i = 0; i < alen; ++i)
         a[i] = (uchar)after.latin1()[i];
     return replace(before.constData(), before.d->size, (const QChar *)a.data(), alen, cs);
 }

◆ replace() [9/12]

QString & QString::replace	(	const QString &	before,
		const QString &	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2031 of file qstring.cpp.

 {
     return replace(before.constData(), before.size(), after.constData(), after.size(), cs);
 }

◆ replace() [10/12]

QString & QString::replace	(	QChar	c,
		const QString &	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2176 of file qstring.cpp.

 {
     if (after.d->size == 0)
         return remove(ch, cs);
 
     if (after.d->size == 1)
         return replace(ch, after.d->data[0], cs);
 
     if (d->size == 0)
         return *this;
 
     ushort cc = (cs == Qt::CaseSensitive ? ch.unicode() : ch.toCaseFolded().unicode());
 
     int index = 0;
     while (1) {
         uint indices[1024];
         uint pos = 0;
         if (cs == Qt::CaseSensitive) {
             while (pos < 1023 && index < d->size) {
                 if (d->data[index] == cc)
                     indices[pos++] = index;
                 index++;
             }
         } else {
             while (pos < 1023 && index < d->size) {
                 if (QChar::toCaseFolded(d->data[index]) == cc)
                     indices[pos++] = index;
                 index++;
             }
         }
         if (!pos)
             break;
 
         replace_helper(indices, pos, 1, after.constData(), after.d->size);
 
         if (index == -1)
             break;
         // index has to be adjusted in case we get back into the loop above.
         index += pos*(after.d->size - 1);
     }
     return *this;
 }

◆ replace() [11/12]

QString & QString::replace	(	QChar	c,
		const QLatin1String &	after,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)

Definition at line 2349 of file qstring.cpp.

 {
     int alen = qstrlen(after.latin1());
     QVarLengthArray<ushort> a(alen);
     for (int i = 0; i < alen; ++i)
         a[i] = (uchar)after.latin1()[i];
     return replace(&c, 1, (const QChar *)a.data(), alen, cs);
 }

◆ replace() [12/12]

QString & QString::replace	(	const QRegExp &	rx,
		const QString &	after
	)

Definition at line 3072 of file qstring.cpp.

 {
     QRegExp rx2(rx);
 
     if (isEmpty() && rx2.indexIn(*this) == -1)
         return *this;
 
     realloc();
 
     int index = 0;
     int numCaptures = rx2.captureCount();
     int al = after.length();
     QRegExp::CaretMode caretMode = QRegExp::CaretAtZero;
 
     if (numCaptures > 0) {
         const QChar *uc = after.unicode();
         int numBackRefs = 0;
 
         for (int i = 0; i < al - 1; i++) {
             if (uc[i] == QLatin1Char('\\')) {
                 int no = uc[i + 1].digitValue();
                 if (no > 0 && no <= numCaptures)
                     numBackRefs++;
             }
         }
 
         /*
             This is the harder case where we have back-references.
         */
         if (numBackRefs > 0) {
             QVarLengthArray<QStringCapture, 16> captures(numBackRefs);
             int j = 0;
 
             for (int i = 0; i < al - 1; i++) {
                 if (uc[i] == QLatin1Char('\\')) {
                     int no = uc[i + 1].digitValue();
                     if (no > 0 && no <= numCaptures) {
                         QStringCapture capture;
                         capture.pos = i;
                         capture.len = 2;
 
                         if (i < al - 2) {
                             int secondDigit = uc[i + 2].digitValue();
                             if (secondDigit != -1 && ((no * 10) + secondDigit) <= numCaptures) {
                                 no = (no * 10) + secondDigit;
                                 ++capture.len;
                             }
                         }
 
                         capture.no = no;
                         captures[j++] = capture;
                     }
                 }
             }
 
             while (index <= length()) {
                 index = rx2.indexIn(*this, index, caretMode);
                 if (index == -1)
                     break;
 
                 QString after2(after);
                 for (j = numBackRefs - 1; j >= 0; j--) {
                     const QStringCapture &capture = captures[j];
                     after2.replace(capture.pos, capture.len, rx2.cap(capture.no));
                 }
 
                 replace(index, rx2.matchedLength(), after2);
                 index += after2.length();
 
                 // avoid infinite loop on 0-length matches (e.g., QRegExp("[a-z]*"))
                 if (rx2.matchedLength() == 0)
                     ++index;
 
                 caretMode = QRegExp::CaretWontMatch;
             }
             return *this;
         }
     }
 
     /*
         This is the simple and optimized case where we don't have
         back-references.
     */
     while (index != -1) {
         struct {
             int pos;
             int length;
         } replacements[2048];
 
         int pos = 0;
         int adjust = 0;
         while (pos < 2047) {
             index = rx2.indexIn(*this, index, caretMode);
             if (index == -1)
                 break;
             int ml = rx2.matchedLength();
             replacements[pos].pos = index;
             replacements[pos++].length = ml;
             index += ml;
             adjust += al - ml;
             // avoid infinite loop
             if (!ml)
                 index++;
         }
         if (!pos)
             break;
         replacements[pos].pos = d->size;
         int newlen = d->size + adjust;
 
         // to continue searching at the right position after we did
         // the first round of replacements
         if (index != -1)
             index += adjust;
         QString newstring;
         newstring.reserve(newlen + 1);
         QChar *newuc = newstring.data();
         QChar *uc = newuc;
         int copystart = 0;
         int i = 0;
         while (i < pos) {
             int copyend = replacements[i].pos;
             int size = copyend - copystart;
             memcpy(uc, d->data + copystart, size * sizeof(QChar));
             uc += size;
             memcpy(uc, after.d->data, al * sizeof(QChar));
             uc += al;
             copystart = copyend + replacements[i].length;
             i++;
         }
         memcpy(uc, d->data + copystart, (d->size - copystart) * sizeof(QChar));
         newstring.resize(newlen);
         *this = newstring;
         caretMode = QRegExp::CaretWontMatch;
     }
     return *this;
 }

◆ replace_helper()

void QString::replace_helper	(	uint *	indices,
		int	nIndices,
		int	blen,
		const QChar *	after,
		int	alen
	)

private

Warning: This function is not part of the public interface.

Definition at line 2039 of file qstring.cpp.

Referenced by replace().

 {
     // copy *after in case it lies inside our own d->data area
     // (which we could possibly invalidate via a realloc or corrupt via memcpy operations.)
     QChar *afterBuffer = const_cast<QChar *>(after);
     if (after >= reinterpret_cast<QChar *>(d->data) && after < reinterpret_cast<QChar *>(d->data) + d->size) {
         afterBuffer = static_cast<QChar *>(qMalloc(alen*sizeof(QChar)));
         Q_CHECK_PTR(afterBuffer);
         ::memcpy(afterBuffer, after, alen*sizeof(QChar));
     }
 
     QT_TRY {
         if (blen == alen) {
             // replace in place
             detach();
             for (int i = 0; i < nIndices; ++i)
                 memcpy(d->data + indices[i], afterBuffer, alen * sizeof(QChar));
         } else if (alen < blen) {
             // replace from front
             detach();
             uint to = indices[0];
             if (alen)
                 memcpy(d->data+to, after, alen*sizeof(QChar));
             to += alen;
             uint movestart = indices[0] + blen;
             for (int i = 1; i < nIndices; ++i) {
                 int msize = indices[i] - movestart;
                 if (msize > 0) {
                     memmove(d->data + to, d->data + movestart, msize * sizeof(QChar));
                     to += msize;
                 }
                 if (alen) {
                     memcpy(d->data + to, afterBuffer, alen*sizeof(QChar));
                     to += alen;
                 }
                 movestart = indices[i] + blen;
             }
             int msize = d->size - movestart;
             if (msize > 0)
                 memmove(d->data + to, d->data + movestart, msize * sizeof(QChar));
             resize(d->size - nIndices*(blen-alen));
         } else {
             // replace from back
             int adjust = nIndices*(alen-blen);
             int newLen = d->size + adjust;
             int moveend = d->size;
             resize(newLen);
 
             while (nIndices) {
                 --nIndices;
                 int movestart = indices[nIndices] + blen;
                 int insertstart = indices[nIndices] + nIndices*(alen-blen);
                 int moveto = insertstart + alen;
                 memmove(d->data + moveto, d->data + movestart,
                         (moveend - movestart)*sizeof(QChar));
                 memcpy(d->data + insertstart, afterBuffer, alen*sizeof(QChar));
                 moveend = movestart-blen;
             }
         }
     } QT_CATCH(const std::bad_alloc &) {
         if (afterBuffer != after)
             qFree(afterBuffer);
         QT_RETHROW;
     }
     if (afterBuffer != after)
         qFree(afterBuffer);
 }

◆ reserve()

void QString::reserve ( int size )

inline

Attempts to allocate memory for at least size characters.

If you know in advance how large the string will be, you can call this function, and if you resize the string often you are likely to get better performance. If size is an underestimate, the worst that will happen is that the QString will be a bit slower.

The sole purpose of this function is to provide a means of fine tuning QString's memory usage. In general, you will rarely ever need to call this function. If you want to change the size of the string, call resize().

This function is useful for code that needs to build up a long string and wants to avoid repeated reallocation. In this example, we want to add to the string until some condition is true, and we're fairly sure that size is large enough to make a call to reserve() worthwhile:

    QString result;
    int maxSize;
    bool condition;
    QChar nextChar;
    result.reserve(maxSize);
    while (condition)
        result.append(nextChar);
    result.squeeze();

See also: squeeze(), capacity()

Definition at line 881 of file qstring.h.

Referenced by QDBusConnectionPrivate::activateCall(), QTextHtmlImporter::appendNodeText(), QXmlStreamReaderPrivate::clearTextBuffer(), QPatternist::ColoringMessageHandler::colorifyDescription(), Qt::escape(), QRegExp::escape(), QPatternist::escape(), QPatternist::TranslateFN::evaluateSingleton(), QMYSQLDriver::formatValue(), QXmlStreamReaderPrivate::getChar_helper(), QDBusConnectionPrivate::handleSignal(), QScriptSyntaxHighlighter::highlightBlock(), QXmlStreamReaderPrivate::init(), QSettingsPrivate::iniUnescapedKey(), QCss::ValueExtractor::lengthValue(), QCss::Symbol::lexem(), QSqlResultPrivate::namedToPositionalBinding(), QScriptEnginePrivate::newRegExp(), QPatternist::XQueryTokenizer::nextToken(), QPatternist::XQueryTokenizer::normalizeEOL(), operator+=(), QDeclarativeStyledTextPrivate::parse(), QPatternist::ReplaceFN::parseReplacement(), QSqlResultPrivate::positionalToNamedBinding(), QDBusConnectionPrivate::prepareHook(), qIsEffectiveTLD(), qReplacePlaceholderMarkers(), QtPrivate::QStringList_join(), qt_ACE_do(), QXmlFormatterPrivate::QXmlFormatterPrivate(), QConfFileSettingsPrivate::readIniSection(), QSqlRelationalTableModelPrivate::relationField(), repeated(), replace(), QSqlDriver::sqlStatement(), QPatternist::HexBinary::stringValue(), QTextBlock::text(), QTextHtmlExporter::toHtml(), QPatternist::XQueryTokenizer::tokenizeStringLiteral(), QProcessEnvironmentPrivate::toList(), typeNameToXml(), QXmlSerializer::writeEscaped(), QXmlStreamWriterPrivate::writeEscaped(), QXmlSerializer::writeEscapedAttribute(), and QPatternist::AbstractDateTime::zoneOffsetToString().

881 { if (d->ref != 1 || asize > d->alloc) realloc(asize); d->capacity = 1;}

QString::realloc

void realloc()

Definition: qstring.cpp:1472

QString::Data::capacity

ushort capacity

Definition: qstring.h:611

QBasicAtomicInt ref

Definition: qstring.h:604

QString::Data::alloc

int alloc

Definition: qstring.h:605

Referenced by _q_parseUnixDir(), QXmlStreamPrivateTagStack::addToStringStorage(), append(), chop(), QXmlStreamReaderPrivate::clearTextBuffer(), QTextDocumentPrivate::compressPieceTable(), QWindowsMimeText::convertFromMime(), QBuiltInMimes::convertFromMime(), QGb18030Codec::convertToUnicode(), QIsciiCodec::convertToUnicode(), QGbkCodec::convertToUnicode(), QUtf32::convertToUnicode(), QGb2312Codec::convertToUnicode(), QPatternist::CompressedWhitespace::decompress(), expand(), QXmlStreamReaderPrivate::fastScanContentCharList(), QXmlStreamReaderPrivate::fastScanName(), QXmlStreamReaderPrivate::fastScanNMTOKEN(), fill(), QTextStreamPrivate::fillReadBuffer(), fromStdWString(), QXmlStreamReaderPrivate::getChar_helper(), getEnglishName(), QSettingsPrivate::iniUnescapedStringList(), leftJustified(), QResourceRoot::name(), operator+=(), operator>>(), QTextDocumentPrivate::plainText(), qt_ACE_do(), qt_nameprep(), QtWndProc(), QXmlFormatterPrivate::QXmlFormatterPrivate(), remove(), replace(), replace_helper(), rightJustified(), QXmlStreamReaderPrivate::scanString(), QXmlStreamReaderPrivate::scanUntil(), setUnicode(), toLower(), toPunycodeHelper(), QTextDecoder::toUnicode(), toUpper(), truncate(), updateValue(), and QXIMInputContext::x11FilterEvent().

Data * d

Definition: qstring.h:618

◆ resize()

void QString::resize ( int size )

Sets the size of the string to size characters.

If size is greater than the current size, the string is extended to make it size characters long with the extra characters added to the end. The new characters are uninitialized.

If size is less than the current size, characters are removed from the end.

Example:

    QString s = "Hello world";
    s.resize(5);
    // s == "Hello"
    s.resize(8);
    // s == "Hello???" (where ? stands for any character)

If you want to append a certain number of identical characters to the string, use operator+=() as follows rather than resize():

    QString t = "Hello";
    t += QString(10, 'X');
    // t == "HelloXXXXXXXXXX"

If you want to expand the string so that it reaches a certain width and fill the new positions with a particular character, use the leftJustified() function:

If size is negative, it is equivalent to passing zero.

    QString r = "Hello";
    r = r.leftJustified(10, ' ');
    // r == "Hello     "

See also: truncate(), reserve()

Definition at line 1353 of file qstring.cpp.

 {
     if (size < 0)
         size = 0;
 
     if (size == 0 && !d->capacity) {
         Data *x = &shared_empty;
         x->ref.ref();
         if (!d->ref.deref())
             QString::free(d);
         d = x;
     } else {
         if (d->ref != 1 || size > d->alloc ||
             (!d->capacity && size < d->size && size < d->alloc >> 1))
             realloc(grow(size));
         if (d->alloc >= size) {
             d->size = size;
             if (d->data == d->array) {
                 d->array[size] = '\0';
             }
         }
     }
 }

◆ right()

QString QString::right ( int n ) const

Returns a substring that contains the n rightmost characters of the string.

The entire string is returned if n is greater than size() or less than zero.

QString x = "Pineapple";

QString y = x.right(5); // y == "apple"

See also: left(), mid(), endsWith()

Definition at line 3682 of file qstring.cpp.

Referenced by _q_escapeIdentifier(), QKeySequence::assign(), computeElidedText(), QNativeWifiEngine::disconnectFromId(), DumpIDL(), QFileSystemEngine::fillPermissions(), QPatternist::NamePool::fromClarkName(), QUrl::fromLocalFile(), getLocations(), QGtkStylePrivate::getThemeName(), QLCDNumberPrivate::internalSetString(), isUncRoot(), loadEngine(), menuItemEntry(), QGtkStyle::pixelMetric(), qIsEffectiveTLD(), qSplitTableAndOwner(), QFileDialogPrivate::qt_mac_filedialog_event_proc(), QFileDialogPrivate::qt_mac_filedialog_filter_proc(), qt_set_x11_resources(), qTopLevelDomain(), QUrlPrivate::setUserInfo(), QMenuPrivate::QMacMenuPrivate::syncAction(), and UpdateRegistry().

 {
     if (n >= d->size || n < 0)
         return *this;
     return QString((const QChar*) d->data + d->size - n, n);
 }

◆ rightJustified()

QString QString::rightJustified	(	int	width,
		QChar	fill = `QLatin1Char(' ')`,
		bool	truncate = `false`
	)		const

Returns a string of size() width that contains the fill character followed by the string.

For example:

QString s = "apple";

QString t = s.rightJustified(8, '.'); // t == "...apple"

If truncate is false and the size() of the string is more than width, then the returned string is a copy of the string.

If truncate is true and the size() of the string is more than width, then the resulting string is truncated at position width.

QString str = "Pineapple";

str = str.rightJustified(5, '.', true); // str == "Pinea"

See also: leftJustified()

Definition at line 5357 of file qstring.cpp.

Referenced by getFmtString(), QLCDNumberPrivate::internalSetString(), and vsprintf().

 {
     QString result;
     int len = length();
     int padlen = width - len;
     if (padlen > 0) {
         result.resize(len+padlen);
         QChar *uc = (QChar*)result.d->data;
         while (padlen--)
            * uc++ = fill;
         if (len)
             memcpy(uc, d->data, sizeof(QChar)*len);
     } else {
         if (truncate)
             result = left(width);
         else
             result = *this;
     }
     return result;
 }

◆ rightRef()

QStringRef QString::rightRef ( int n ) const

Returns a substring reference to the n rightmost characters of the string.

Since: 4.4

If n is greater than size() or less than zero, a reference to the entire string is returned.

QString x = "Pineapple";

QStringRef y = x.rightRef(5); // y == "apple"

See also: right(), leftRef(), midRef(), endsWith()

Definition at line 9068 of file qstring.cpp.

 {
     if (n >= d->size || n < 0)
         n = d->size;
     return QStringRef(this, d->size - n, n);
 }

◆ section() [1/3]

QString QString::section	(	QChar	sep,
		int	start,
		int	end = `-1`,
		SectionFlags	flags = `SectionDefault`
	)		const

inline

This function returns a section of the string.

This string is treated as a sequence of fields separated by the character, sep. The returned string consists of the fields from position start to position end inclusive. If end is not specified, all fields from position start to the end of the string are included. Fields are numbered 0, 1, 2, etc., counting from the left, and -1, -2, etc., counting from right to left.

The flags argument can be used to affect some aspects of the function's behavior, e.g. whether to be case sensitive, whether to skip empty fields and how to deal with leading and trailing separators; see SectionFlags.

    QString str;
    QString csv = "forename,middlename,surname,phone";
    QString path = "/usr/local/bin/myapp"; // First field is empty
    QString::SectionFlag flag = QString::SectionSkipEmpty;
    str = csv.section(',', 2, 2);   // str == "surname"
    str = path.section('/', 3, 4);  // str == "bin/myapp"
    str = path.section('/', 3, 3, flag); // str == "myapp"

If start or end is negative, we count fields from the right of the string, the right-most field being -1, the one from right-most field being -2, and so on.

str = csv.section(',', -3, -2); // str == "middlename,surname"

str = path.section('/', -1); // str == "myapp"

See also: split()

Definition at line 781 of file qstring.h.

Referenced by EGLNullWSScreen::connect(), QConnmanEngine::connectToId(), QDeclarativeListViewPrivate::createItem(), QConnmanEngine::disconnectFromId(), QConnmanEngine::isRoamingAllowed(), qt_init(), QVNCIntegration::QVNCIntegration(), section(), QSqlRelationalTableModel::selectStatement(), and QDeclarativeListViewPrivate::updateCurrentSection().

782 { return section(QString(asep), astart, aend, aflags); }

QString::section

QString section(QChar sep, int start, int end=-1, SectionFlags flags=SectionDefault) const

This function returns a section of the string.

Definition: qstring.h:781

QString()

Constructs a null string.

Definition: qstring.h:879

◆ section() [2/3]

QString QString::section	(	const QString &	in_sep,
		int	start,
		int	end = `-1`,
		SectionFlags	flags = `SectionDefault`
	)		const

Definition at line 3526 of file qstring.cpp.

 {
     QStringList sections = split(sep, KeepEmptyParts,
                                  (flags & SectionCaseInsensitiveSeps) ? Qt::CaseInsensitive : Qt::CaseSensitive);
     if (sections.isEmpty())
         return QString();
     if (!(flags & SectionSkipEmpty)) {
         if (start < 0)
             start += sections.count();
         if (end < 0)
             end += sections.count();
     } else {
         int skip = 0;
         for (int k=0; k<sections.size(); ++k) {
             if (sections.at(k).isEmpty())
                 skip++;
         }
         if (start < 0)
             start += sections.count() - skip;
         if (end < 0)
             end += sections.count() - skip;
     }
     int x = 0;
     QString ret;
     int first_i = start, last_i = end;
     for (int i = 0; x <= end && i < sections.size(); ++i) {
         QString section = sections.at(i);
         const bool empty = section.isEmpty();
         if (x >= start) {
             if(x == start)
                 first_i = i;
             if(x == end)
                 last_i = i;
             if(x > start)
                 ret += sep;
             ret += section;
         }
         if (!empty || !(flags & SectionSkipEmpty))
             x++;
     }
     if((flags & SectionIncludeLeadingSep) && first_i)
         ret.prepend(sep);
     if((flags & SectionIncludeTrailingSep) && last_i < sections.size()-1)
         ret += sep;
     return ret;
 }

◆ section() [3/3]

QString QString::section	(	const QRegExp &	reg,
		int	start,
		int	end = `-1`,
		SectionFlags	flags = `SectionDefault`
	)		const

Definition at line 3597 of file qstring.cpp.

 {
     const QChar *uc = unicode();
     if(!uc)
         return QString();
 
     QRegExp sep(reg);
     sep.setCaseSensitivity((flags & SectionCaseInsensitiveSeps) ? Qt::CaseInsensitive
                                                                 : Qt::CaseSensitive);
 
     QList<qt_section_chunk> sections;
     int n = length(), m = 0, last_m = 0, last_len = 0;
     while ((m = sep.indexIn(*this, m)) != -1) {
         sections.append(qt_section_chunk(last_len, QString(uc + last_m, m - last_m)));
         last_m = m;
         last_len = sep.matchedLength();
         m += qMax(sep.matchedLength(), 1);
     }
     sections.append(qt_section_chunk(last_len, QString(uc + last_m, n - last_m)));
 
     if(start < 0)
         start += sections.count();
     if(end < 0)
         end += sections.count();
 
     QString ret;
     int x = 0;
     int first_i = start, last_i = end;
     for (int i = 0; x <= end && i < sections.size(); ++i) {
         const qt_section_chunk &section = sections.at(i);
         const bool empty = (section.length == section.string.length());
         if (x >= start) {
             if(x == start)
                 first_i = i;
             if(x == end)
                 last_i = i;
             if(x != start)
                 ret += section.string;
             else
                 ret += section.string.mid(section.length);
         }
         if (!empty || !(flags & SectionSkipEmpty))
             x++;
     }
     if((flags & SectionIncludeLeadingSep) && first_i < sections.size()) {
         const qt_section_chunk &section = sections.at(first_i);
         ret.prepend(section.string.left(section.length));
     }
     if((flags & SectionIncludeTrailingSep) && last_i+1 <= sections.size()-1) {
         const qt_section_chunk &section = sections.at(last_i+1);
         ret += section.string.left(section.length);
     }
     return ret;
 }

◆ setNum() [1/10]

QString & QString::setNum	(	short	n,
		int	base = `10`
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 729 of file qstring.h.

Referenced by number(), QLabel::setNum(), and setNum().

730 { return setNum(qlonglong(n), base); }

static const uint base

Definition: qurl.cpp:268

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

qint64 qlonglong

Definition: qglobal.h:951

◆ setNum() [2/10]

QString & QString::setNum	(	ushort	n,
		int	base = `10`
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 731 of file qstring.h.

732 { return setNum(qulonglong(n), base); }

static const uint base

Definition: qurl.cpp:268

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

quint64 qulonglong

Definition: qglobal.h:952

◆ setNum() [3/10]

QString & QString::setNum	(	int	n,
		int	base = `10`
	)

inline

Sets the string to the printed value of n in the specified base, and returns a reference to the string.

The base is 10 by default and must be between 2 and 36. For bases other than 10, n is treated as an unsigned integer.

QString str;

str.setNum(1234); // str == "1234"

The formatting always uses QLocale::C, i.e., English/UnitedStates. To get a localized string representation of a number, use QLocale::toString() with the appropriate locale.

Definition at line 733 of file qstring.h.

734 { return setNum(qlonglong(n), base); }

static const uint base

Definition: qurl.cpp:268

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

qint64 qlonglong

Definition: qglobal.h:951

◆ setNum() [4/10]

QString & QString::setNum	(	uint	n,
		int	base = `10`
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 735 of file qstring.h.

736 { return setNum(qulonglong(n), base); }

static const uint base

Definition: qurl.cpp:268

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

quint64 qulonglong

Definition: qglobal.h:952

◆ setNum() [5/10]

QString & QString::setNum	(	long	n,
		int	base = `10`
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 737 of file qstring.h.

738 { return setNum(qlonglong(n), base); }

static const uint base

Definition: qurl.cpp:268

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

qint64 qlonglong

Definition: qglobal.h:951

◆ setNum() [6/10]

QString & QString::setNum	(	ulong	n,
		int	base = `10`
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 739 of file qstring.h.

740 { return setNum(qulonglong(n), base); }

static const uint base

Definition: qurl.cpp:268

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

quint64 qulonglong

Definition: qglobal.h:952

◆ setNum() [7/10]

QString & QString::setNum	(	qlonglong	n,
		int	base = `10`
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6307 of file qstring.cpp.

 {
 #if defined(QT_CHECK_RANGE)
     if (base < 2 || base > 36) {
         qWarning("QString::setNum: Invalid base (%d)", base);
         base = 10;
     }
 #endif
     QLocale locale(QLocale::C);
     *this = locale.d()->longLongToString(n, -1, base);
     return *this;
 }

◆ setNum() [8/10]

QString & QString::setNum	(	qulonglong	n,
		int	base = `10`
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6323 of file qstring.cpp.

 {
 #if defined(QT_CHECK_RANGE)
     if (base < 2 || base > 36) {
         qWarning("QString::setNum: Invalid base (%d)", base);
         base = 10;
     }
 #endif
     QLocale locale(QLocale::C);
     *this = locale.d()->unsLongLongToString(n, -1, base);
     return *this;
 }

◆ setNum() [9/10]

QString & QString::setNum	(	float	n,
		char	format = `'g'`,
		int	precision = `6`
	)

inline

Sets the string to the printed value of n, formatted according to the given format and precision, and returns a reference to the string.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 741 of file qstring.h.

742 { return setNum(double(n),f,prec); }

Referenced by QPatternist::AccelTreeBuilder< true >::attribute(), comify(), QSvgText::draw(), QPatternist::Base64Binary::fromLexical(), QPatternist::XsdTypeChecker::fromLexical(), QPatternist::DerivedString< TypeToken >::fromLexical(), QImageReaderPrivate::getText(), QPatternist::XsdTypeChecker::normalizedValue(), QIBaseDriver::open(), QMYSQLDriver::open(), QSplitter::operator>>(), QHostAddressPrivate::parse(), QDateTimeParser::parse(), QXmlStreamReaderPrivate::parse(), QPatternist::XsdSchemaParser::parseGlobalElement(), QHttpResponseHeader::parseLine(), QHttpRequestHeader::parseLine(), QIBaseDriver::primaryIndex(), QTDSDriver::primaryIndex(), QFtpPI::processReply(), QTextHtmlImporter::processSpecialNodes(), QPatternist::AttributeConstructor::processValue(), QPatternist::XsdValidatingInstanceReader::qNameAttribute(), qODBCWarn(), qParseOpts(), qt_parseEtcLpPrinters(), qt_parsePrinterDesc(), qt_parsePrintersConf(), qt_parseQconfig(), qt_parseSpoolInterface(), qt_perhapsAddPrinter(), qt_set_x11_resources(), qt_strip_filters(), QPatternist::XsdSchemaParser::readNameAttribute(), QPngHandlerPrivate::readPngTexts(), QPatternist::XsdSchemaParser::readQNameAttribute(), QIBaseResult::record(), QIBaseDriver::record(), QTDSDriver::record(), set_text(), QImageWriter::setText(), styleStringHelper(), QIBaseDriver::tables(), QTDSDriver::tables(), QPatternist::AnyURI::toQUrl(), and QPatternist::XsdValidatingInstanceReader::validateElementComplexType().

QString & setNum(short, int base=10)

This is an overloaded member function, provided for convenience. It differs from the above function o...

Definition: qstring.h:729

◆ setNum() [10/10]

QString & QString::setNum	(	double	n,
		char	format = `'g'`,
		int	precision = `6`
	)

Sets the string to the printed value of n, formatted according to the given format and precision, and returns a reference to the string.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

The format can be 'f', 'F', 'e', 'E', 'g' or 'G' (see the arg() function documentation for an explanation of the formats).

Unlike QLocale::toString(), this function doesn't honor the user's locale settings.

Definition at line 6364 of file qstring.cpp.

 {
     QLocalePrivate::DoubleForm form = QLocalePrivate::DFDecimal;
     uint flags = 0;
 
     if (qIsUpper(f))
         flags = QLocalePrivate::CapitalEorX;
     f = qToLower(f);
 
     switch (f) {
         case 'f':
             form = QLocalePrivate::DFDecimal;
             break;
         case 'e':
             form = QLocalePrivate::DFExponent;
             break;
         case 'g':
             form = QLocalePrivate::DFSignificantDigits;
             break;
         default:
 #if defined(QT_CHECK_RANGE)
             qWarning("QString::setNum: Invalid format char '%c'", f);
 #endif
             break;
     }
 
     QLocale locale(QLocale::C);
     *this = locale.d()->doubleToString(n, prec, form, -1, flags);
     return *this;
 }

◆ setRawData()

QString & QString::setRawData	(	const QChar *	unicode,
		int	size
	)

Resets the QString to use the first size Unicode characters in the array unicode.

Since: 4.7

The data in unicode is not copied. The caller must be able to guarantee that unicode will not be deleted or modified as long as the QString (or an unmodified copy of it) exists.

This function can be used instead of fromRawData() to re-use existings QString objects to save memory re-allocations.

See also: fromRawData()

Definition at line 7707 of file qstring.cpp.

 {
     if (d->ref != 1 || (d->data == d->array && d->alloc)) {
         *this = fromRawData(unicode, size);
     } else {
 #ifdef QT3_SUPPORT
         if (d->asciiCache) {
             QMutexLocker locker(asciiCacheMutex());
             Q_ASSERT(asciiCache);
             asciiCache->remove(d);
         }
 #endif
         if (unicode) {
             d->data = (ushort *)unicode;
         } else {
             d->data = d->array;
             size = 0;
         }
         d->alloc = d->size = size;
         *d->array = '\0';
         d->clean = d->asciiCache = d->simpletext = d->righttoleft = d->capacity = 0;
     }
     return *this;
 }

◆ setUnicode()

QString & QString::setUnicode	(	const QChar *	unicode,
		int	size
	)

Resizes the string to size characters and copies unicode into the string.

If unicode is 0, nothing is copied, but the string is still resized to size.

See also: unicode(), setUtf16()

Definition at line 4377 of file qstring.cpp.

Referenced by setUtf16().

 {
      resize(size);
      if (unicode && size)
          memcpy(d->data, unicode, size * sizeof(QChar));
      return *this;
 }

◆ setUtf16()

QString & QString::setUtf16	(	const ushort *	unicode,
		int	size
	)

inline

Resizes the string to size characters and copies unicode into the string.

If unicode is 0, nothing is copied, but the string is still resized to size.

Note that unlike fromUtf16(), this function does not consider BOMs and possibly differing byte ordering.

See also: utf16(), setUnicode()

Definition at line 882 of file qstring.h.

Referenced by vsprintf().

883 { return setUnicode(reinterpret_cast<const QChar *>(autf16), asize); }

QString::setUnicode

QString & setUnicode(const QChar *unicode, int size)

Resizes the string to size characters and copies unicode into the string.

Definition: qstring.cpp:4377

◆ simplified()

QString QString::simplified ( ) const

Returns a string that has whitespace removed from the start and the end, and that has each sequence of internal whitespace replaced with a single space.

Whitespace means any character for which QChar::isSpace() returns true. This includes the ASCII characters '\t', '\n', '\v', '\f', '\r', and ' '.

Example:

    QString str = "  lots\t of\nwhitespace\r\n ";
    str = str.simplified();
    // str == "lots of whitespace";

See also: trimmed()

Definition at line 4415 of file qstring.cpp.

 {
     if (d->size == 0)
         return *this;
 
     const QChar * const start = reinterpret_cast<QChar *>(d->data);
     const QChar *from = start;
     const QChar *fromEnd = start + d->size;
     forever {
         QChar ch = *from;
         if (!ch.isSpace())
             break;
         if (++from == fromEnd) {
             // All-whitespace string
             shared_empty.ref.ref();
             return QString(&shared_empty, 0);
         }
     }
     // This loop needs no underflow check, as we already determined that
     // the string contains non-whitespace. If the string has exactly one
     // non-whitespace, it will be checked twice - we can live with that.
     while (fromEnd[-1].isSpace())
         fromEnd--;
     // The rest of the function depends on the fact that we already know
     // that the last character in the source is no whitespace.
     const QChar *copyFrom = from;
     int copyCount;
     forever {
         if (++from == fromEnd) {
             // Only leading and/or trailing whitespace, if any at all
             return mid(copyFrom - start, from - copyFrom);
         }
         QChar ch = *from;
         if (!ch.isSpace())
             continue;
         if (ch != QLatin1Char(' ')) {
             copyCount = from - copyFrom;
             break;
         }
         ch = *++from;
         if (ch.isSpace()) {
             copyCount = from - copyFrom - 1;
             break;
         }
     }
     // 'from' now points at the non-trailing whitespace which made the
     // string not simplified in the first place. 'copyCount' is the number
     // of already simplified characters - at least one, obviously -
     // without a trailing space.
     QString result((fromEnd - from) + copyCount, Qt::Uninitialized);
     QChar *to = reinterpret_cast<QChar *>(result.d->data);
     ::memcpy(to, copyFrom, copyCount * 2);
     to += copyCount;
     fromEnd--;
     QChar ch;
     forever {
         *to++ = QLatin1Char(' ');
         do {
             ch = *++from;
         } while (ch.isSpace());
         if (from == fromEnd)
             break;
         do {
             *to++ = ch;
             ch = *++from;
             if (from == fromEnd)
                 goto done;
         } while (!ch.isSpace());
     }
   done:
     *to++ = ch;
     result.truncate(to - reinterpret_cast<QChar *>(result.d->data));
     return result;
 }

◆ size()

int QString::size ( ) const

inline

Returns the number of characters in this string.

The last character in the string is at position size() - 1. In addition, QString ensures that the character at position size() is always '\0', so that you can use the return value of data() and constData() as arguments to functions that expect '\0'-terminated strings.

Example:

    QString str = "World";
    int n = str.size();         // n == 5
    str.data()[0];              // returns 'W'
    str.data()[4];              // returns 'd'
    str.data()[5];              // returns '\0'

See also: isEmpty(), resize()

Definition at line 102 of file qstring.h.

102 { return d->size; }

int size

Definition: qstring.h:605

Referenced by QScript::__setupPackage__(), QScriptEngine::availableExtensions(), QCss::StyleSelector::basicSelectorMatches(), Maemo::conn_settings_notify_func(), EGLNullWSScreen::connect(), QQnxScreen::connect(), QVNCScreen::connect(), QVFbScreen::connect(), QMultiScreen::connect(), PvrEglScreen::connect(), QLinuxFbScreen::connect(), QLinuxFbIntegration::connect(), QDirectFBScreen::connect(), convertWithPalette(), QPlatformIntegrationFactory::create(), QScriptDebuggerConsolePrivate::createJob(), createSvgNode(), QScriptDebuggerLocalsModel::data(), determineScreenSize(), QGtkStylePrivate::extract_filter(), familyList(), QWSSoundServerPrivate::feedDevice(), QDeclarativeStateGroupPrivate::findTransition(), QDate::fromString(), QFont::fromString(), QDateTime::fromString(), QImageReaderPrivate::getText(), QGtkStylePrivate::getThemeName(), QScriptToolTipJob::handleResponse(), QGuiPlatformPlugin::iconThemeSearchPaths(), QScriptEngine::importExtension(), QDirModel::index(), QDeclarativePropertyPrivate::initProperty(), QPatternist::XSLTTokenizer::insideTemplate(), QLibrary::isLibrary(), QPatternist::XPathHelper::isQName(), QDBusUtil::isValidBusName(), QDBusUtil::isValidInterfaceName(), QDBusUtil::isValidObjectPath(), QPatternist::XsdTypeChecker::isValidString(), QDBusUtil::isValidUniqueConnectionName(), QMetaEnum::keysToValue(), QStringList::lastIndexOf(), libGreaterThan(), libraryPathList(), QCoreApplication::libraryPaths(), QSystemLibrary::load(), QAxServerBase::Load(), QLibraryInfo::location(), QResourceRoot::mappingRootSubdir(), QFileSystemModelPrivate::node(), QDBusConnection::objectRegisteredAt(), QIBaseDriver::open(), QSQLiteDriver::open(), QDB2Driver::open(), QMYSQLDriver::open(), QWSServer::openKeyboard(), QWSServer::openMouse(), operator<<(), QHttpHeader::parse(), parseAnimateColorNode(), QPatternist::XsdSchemaParser::parseAny(), QPatternist::XsdSchemaParser::parseAnyAttribute(), QPatternist::XsdSchemaParser::parseGlobalElement(), parseIp4(), parseIp6(), QHttpRequestHeader::parseLine(), QPatternist::XsdSchemaParser::parseSchema(), QHostAddress::parseSubnet(), QPatternist::XsdSchemaParser::parseUnion(), QGtkStyle::pixelMetric(), QTDSDriver::primaryIndex(), QFtpPI::processReply(), qDBusGenerateMetaObjectXml(), qDBusInterfaceFromMetaObject(), QDeclarativeImportDatabase::QDeclarativeImportDatabase(), qExtractSecurityPolicyFromString(), qGetODBCVersion(), QLinuxInputKeyboardHandler::QLinuxInputKeyboardHandler(), qOpenGLVersionFlagsFromString(), qParseOpts(), qSplitTableQualifier(), QSslSocketBackendPrivate::QSslCipher_from_SSL_CIPHER(), qt_clean_filter_list(), qt_getDefaultFromHomePrinters(), QApplicationPrivate::qt_mac_apply_settings(), QFileDialogPrivate::qt_mac_filedialog_event_proc(), QFileDialogPrivate::qt_mac_filedialog_filter_proc(), qt_make_filter_list(), qt_parsePrinterDesc(), qt_parsePrintersConf(), qt_tildeExpansion(), qt_win_extract_filter(), qTopLevelDomain(), QWin32PrintEnginePrivate::queryDefault(), QWSKbPrivate::QWSKbPrivate(), QWSLinuxInputKbPrivate::QWSLinuxInputKbPrivate(), QWSLinuxInputMousePrivate::QWSLinuxInputMousePrivate(), QWSPcMouseHandlerPrivate::QWSPcMouseHandlerPrivate(), QWSTslibMouseHandlerPrivate::QWSTslibMouseHandlerPrivate(), QWSTtyKbPrivate::QWSTtyKbPrivate(), rasterFallbacksMask(), QPatternist::XsdSchemaParser::readBlockingConstraintAttribute(), QPatternist::XsdSchemaParser::readDerivationConstraintAttribute(), registerFont(), QDBusConnection::registerObject(), QDir::relativeFilePath(), QAxServerBase::Save(), section(), set_text(), QSslSocket::setCiphers(), QDirectFBScreenPrivate::setFlipFlags(), QScriptExtensionPlugin::setupPackage(), QDirPrivate::splitFilters(), QFSCompleter::splitPath(), QCompleter::splitPath(), QPatternist::XPathHelper::splitQName(), QProcessPrivate::startDetached(), QProcessPrivate::startProcess(), stringToList(), QFileDialogPrivate::typedFiles(), uncShareExists(), QDBusConnection::unregisterObject(), QPatternist::XsdValidatingInstanceReader::validate(), QPatternist::XsdValidatingInstanceReader::validateAttribute(), QPatternist::XsdValidatingInstanceReader::validateElementSimpleType(), QPatternist::XsdTypeChecker::valuesAreEqual(), and QApplicationPrivate::x11_apply_settings().

Data * d

Definition: qstring.h:618

◆ split() [1/3]

QStringList QString::split	(	const QString &	sep,
		SplitBehavior	behavior = `KeepEmptyParts`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Splits the string into substrings wherever sep occurs, and returns the list of those strings.

If sep does not match anywhere in the string, split() returns a single-element list containing this string.

cs specifies whether sep should be matched case sensitively or case insensitively.

If behavior is QString::SkipEmptyParts, empty entries don't appear in the result. By default, empty entries are kept.

Example:

    QString str = "a,,b,c";
    QStringList list1 = str.split(",");
    // list1: [ "a", "", "b", "c" ]
    QStringList list2 = str.split(",", QString::SkipEmptyParts);
    // list2: [ "a", "b", "c" ]

See also: QStringList::join(), section()

Definition at line 6526 of file qstring.cpp.

 {
     QStringList list;
     int start = 0;
     int extra = 0;
     int end;
     while ((end = indexOf(sep, start + extra, cs)) != -1) {
         if (start != end || behavior == KeepEmptyParts)
             list.append(mid(start, end - start));
         start = end + sep.size();
         extra = (sep.size() == 0 ? 1 : 0);
     }
     if (start != size() || behavior == KeepEmptyParts)
         list.append(mid(start));
     return list;
 }

◆ split() [2/3]

QStringList QString::split	(	const QChar &	sep,
		SplitBehavior	behavior = `KeepEmptyParts`,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 6546 of file qstring.cpp.

 {
     QStringList list;
     int start = 0;
     int end;
     while ((end = indexOf(sep, start, cs)) != -1) {
         if (start != end || behavior == KeepEmptyParts)
             list.append(mid(start, end - start));
         start = end + 1;
     }
     if (start != size() || behavior == KeepEmptyParts)
         list.append(mid(start));
     return list;
 }

◆ split() [3/3]

QStringList QString::split	(	const QRegExp &	rx,
		SplitBehavior	behavior = `KeepEmptyParts`
	)		const

Splits the string into substrings wherever the regular expression rx matches, and returns the list of those strings.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

If rx does not match anywhere in the string, split() returns a single-element list containing this string.

Here's an example where we extract the words in a sentence using one or more whitespace characters as the separator:

    QString str;
    QStringList list;
    str = "Some  text\n\twith  strange whitespace.";
    list = str.split(QRegExp("\\s+"));
    // list: [ "Some", "text", "with", "strange", "whitespace." ]

Here's a similar example, but this time we use any sequence of non-word characters as the separator:

    str = "This time, a normal English sentence.";
    list = str.split(QRegExp("\\W+"), QString::SkipEmptyParts);
    // list: [ "This", "time", "a", "normal", "English", "sentence" ]

Here's a third example where we use a zero-length assertion, \b (word boundary), to split the string into an alternating sequence of non-word and word tokens:

    str = "Now: this sentence fragment.";
    list = str.split(QRegExp("\\b"));
    // list: [ "", "Now", ": ", "this", " ", "sentence", " ", "fragment", "." ]

See also: QStringList::join(), section()

Definition at line 6591 of file qstring.cpp.

 {
     QRegExp rx2(rx);
     QStringList list;
     int start = 0;
     int extra = 0;
     int end;
     while ((end = rx2.indexIn(*this, start + extra)) != -1) {
         int matchedLen = rx2.matchedLength();
         if (start != end || behavior == KeepEmptyParts)
             list.append(mid(start, end - start));
         start = end + matchedLen;
         extra = (matchedLen == 0) ? 1 : 0;
     }
     if (start != size() || behavior == KeepEmptyParts)
         list.append(mid(start));
     return list;
 }

◆ sprintf()

QString & QString::sprintf	(	const char *	cformat,
			...
	)

Safely builds a formatted string from the format string cformat and an arbitrary list of arguments.

The lc escape sequence expects a unicode character of type ushort (as returned by QChar::unicode()). The ls escape sequence expects a pointer to a zero-terminated array of unicode characters of type ushort (as returned by QString::utf16()).

Note: This function expects a UTF-8 string for s and Latin-1 for the format string.

The format string supports most of the conversion specifiers provided by printf() in the standard C++ library. It doesn't honor the length modifiers (e.g. h for short, ll for long long). If you need those, use the standard snprintf() function instead:

    size_t BufSize;
    char buf[BufSize];
    ::snprintf(buf, BufSize, "%lld", 123456789LL);
    QString str = QString::fromAscii(buf);

Warning: We do not recommend using QString::sprintf() in new Qt code. Instead, consider using QTextStream or arg(), both of which support Unicode strings seamlessly and are type-safe. Here's an example that uses QTextStream:

    QString result;
    QTextStream(&result) << "pi = " << 3.14;
    // result == "pi = 3.14"

For QObject::tr(){translations}, especially if the strings contains more than one escape sequence, you should consider using the arg() function instead. This allows the order of the replacements to be controlled by the translator.

See also: arg()

Definition at line 5567 of file qstring.cpp.

Referenced by QVNCScreenPrivate::configure(), decodeMSG(), QHashData::destroyAndFree(), double2string(), int2string(), QColor::name(), QMapData::node_delete(), qt_parseEtcLpPrinters(), QHostAddress::toString(), and write_xpm_image().

 {
     va_list ap;
     va_start(ap, cformat);
     QString &s = vsprintf(cformat, ap);
     va_end(ap);
     return s;
 }

◆ squeeze()

void QString::squeeze ( )

inline

Releases any memory not required to store the character data.

The sole purpose of this function is to provide a means of fine tuning QString's memory usage. In general, you will rarely ever need to call this function.

See also: reserve(), capacity()

Definition at line 114 of file qstring.h.

Referenced by QTextDocumentPrivate::compressPieceTable(), QSettingsPrivate::iniUnescapedStringList(), QSqlResultPrivate::namedToPositionalBinding(), QSqlResultPrivate::positionalToNamedBinding(), and qReplacePlaceholderMarkers().

114 { if (d->size < d->alloc || d->ref != 1) realloc(); d->capacity = 0;}

QString::realloc

void realloc()

Definition: qstring.cpp:1472

QString::Data::capacity

ushort capacity

Definition: qstring.h:611

int size

Definition: qstring.h:605

QBasicAtomicInt ref

Definition: qstring.h:604

QString::Data::alloc

int alloc

Definition: qstring.h:605

Referenced by QFileDialogPrivate::_q_autoCompleteFileName(), QCompleterPrivate::_q_fileSystemModelDirectoryLoaded(), _q_parseUnixDir(), QFontComboBoxPrivate::_q_updateModel(), QFileDialogPrivate::_q_updateOkButton(), QFtpPI::abort(), QNSOpenSavePanelDelegate::acceptableExtensionsForSave, QIcdEngine::addConfiguration(), addFontToDatabase(), QLocalServerPrivate::addListener(), QResource::addSearchPath(), QTextCodec::availableCodecs(), QTextCodec::availableMibs(), QCss::StyleSelector::basicSelectorMatches(), QUnsortedModelEngine::buildIndices(), QWindowsMimeText::canConvertToMime(), QDir::cd(), QMacSettingsPrivate::children(), cleanPath(), QODBCDriver::cleanup(), QDeclarativeStringConverters::colorFromString(), QDeclarativeConnectionsParser::compile(), QScriptDebuggerConsoleCommandManager::completions(), QVNCScreen::connect(), QVFbScreen::connect(), QMultiScreen::connect(), QTransformedScreen::connect(), QLinuxFbScreen::connect(), QLocalSocket::connectToServer(), QScriptDebuggerConsole::consumeInput(), QMacPasteboardMimeHTMLText::convertFromMime(), QTextCodecPlugin::create(), createImageNode(), QDBusMetaObject::createMetaObject(), QDeclarativeListModelParser::definesEmptyList(), QLocalSocketPrivate::destroyPipeHandles(), QTranslatorPrivate::do_load(), QIcdEngine::doRequestUpdate(), QSvgText::draw(), QResourcePrivate::ensureChildren(), QResourcePrivate::ensureInitialized(), QConfFileSettingsPrivate::ensureSectionParsed(), QDB2Driver::escapeIdentifier(), QIBaseDriver::escapeIdentifier(), QSQLite2Driver::escapeIdentifier(), QTDSDriver::escapeIdentifier(), QMYSQLDriver::escapeIdentifier(), QPSQLDriver::escapeIdentifier(), QODBCDriver::escapeIdentifier(), extractEncodingDecl(), familyList(), QSortedModelEngine::filter(), QCompletionEngine::filterHistory(), QDeclarativeImportedNamespace::find(), QNetworkAuthenticationCache::findClosestMatch(), QDateTimeParser::findDay(), QDateTimeParser::findMonth(), QResourceRoot::findNode(), fixIfRelativeUncPath(), QMacPasteboardMimeTiff::flavorFor(), QMacPasteboardMimeUrl::flavorFor(), QMacPasteboardMimeVCard::flavorFor(), QWindowsMimeText::formatsForMime(), QDirectFBPixmapData::fromFile(), QDirectFbBlitterPlatformPixmap::fromFile(), QUrl::fromLocalFile(), QSslCertificate::fromPath(), QDateTime::fromString(), QFileInfoGatherer::getFileInfos(), getFmtString(), getImage(), QFileSystemEngine::getLinkTarget(), getLocations(), getPixmap(), getVariables(), QInternalMimeData::hasFormatHelper(), QUrl::host(), QDirModel::index(), QSQLite2ResultPrivate::init(), QPatternist::XSLTTokenizer::insideSequenceConstructor(), isCustomMimeType(), isDirPath(), QMYSQLDriver::isIdentifierEscapedImplementation(), QODBCDriver::isIdentifierEscapedImplementation(), QSqlDriver::isIdentifierEscapedImplementation(), QPatternist::LangFN::isLangMatch(), QStyleSheetStyle::isNaturalChild(), isParentDomain(), QUrl::isParentOf(), isParentPath(), isPrefixOf(), isSignalPropertyName(), isUncRoot(), QDBusUtil::isValidBusName(), QDBusUtil::isValidObjectPath(), QDBusUtil::isValidUniqueConnectionName(), launchWebBrowser(), QLocalServerPrivate::listen(), QLibraryPrivate::load_sys(), QFSFileEnginePrivate::longFileName(), QAbstractItemModel::match(), QXlibMime::mimeAtomForFormat(), QMacPasteboardMimeAny::mimeFor(), QLastResortMimes::mimeForFormat(), QDirModelPrivate::name(), nameToType(), QFileSystemEngine::nativeAbsoluteFilePath(), QFileSystemModelPrivate::node(), QSQLiteDriver::open(), QStringRef::operator=(), QNSOpenSavePanelDelegate::panel:shouldShowFilename:, parseColorValue(), QDeclarativeBindingCompilerPrivate::parseName(), QFSCompleter::pathFromIndex(), QGtkStyle::pixelMetric(), QHttpNetworkConnectionPrivate::prepareRequest(), QFtpPI::processReply(), QGlobalNetworkProxy::proxyForQuery(), QDBusAbstractInterface::QDBusAbstractInterface(), qDBusGenerateMetaObjectXml(), qDBusInterfaceFromMetaObject(), QDeclarativeGridScaledImage::QDeclarativeGridScaledImage(), qDecodeOCIType(), qGetColumnType(), QLinuxInputKeyboardHandler::QLinuxInputKeyboardHandler(), QLinuxInputMouseHandler::QLinuxInputMouseHandler(), qmlsqldatabase_executeSql_readonly(), qmlxmlhttprequest_setRequestHeader(), qOpenGLVersionFlagsFromString(), QSslSocketBackendPrivate::QSslCipher_from_SSL_CIPHER(), qt_create_commandline(), qt_mac_menu_merge_action(), qt_parseEtcLpPrinters(), qt_parseSpoolInterface(), qt_resource_fixResourceRoot(), qt_tildeExpansion(), QVNCIntegration::QVNCIntegration(), QWinSettingsPrivate::QWinSettingsPrivate(), QWSKbPrivate::QWSKbPrivate(), QWSLinuxInputKbPrivate::QWSLinuxInputKbPrivate(), QWSLinuxInputMousePrivate::QWSLinuxInputMousePrivate(), QWSTtyKbPrivate::QWSTtyKbPrivate(), readConf(), readLink(), readSourceFile(), QPatternist::XsdSchemaParser::readXPathAttribute(), QDir::relativeFilePath(), removeOptionalQuotes(), QLocalServerPrivate::removeServer(), QInternalMimeData::renderDataHelper(), QSslSocketPrivate::resetDefaultCiphers(), QDeclarativeImportsPrivate::resolvedUri(), QFileSystemEntry::resolveFilePath(), QDeclarativeImportDatabase::resolvePlugin(), QColor::setColorFromString(), QNetworkCookieJar::setCookiesFromUrl(), QCalendarDateValidator::setFormat(), QDeclarativeXmlListModel::setQuery(), QDeclarativeXmlListModelRole::setQuery(), QTextBrowserPrivate::setSource(), shouldWatchService(), QFtpDTP::socketReadyRead(), QFSCompleter::splitPath(), QCompleter::splitPath(), QFtpPI::startNextCmd(), QSettingsPrivate::stringListToVariantList(), QSettingsPrivate::stringToVariant(), QAbstractSpinBoxPrivate::stripped(), stripTextDecl(), QSvgNode::styleProperty(), QStyleSheetStyle::styleRules(), QNetworkProxyFactory::systemProxyForQuery(), QAudioDeviceInfoInternal::testSettings(), QClipboard::text(), QmlJSDebugger::AbstractLiveEditTool::titleForItem(), QUrlPrivate::toEncoded(), QFileDialogPrivate::toInternal(), QNetworkCookie::toRawForm(), QUrl::toString(), totalDigitsForSignedLongLong(), QFileInfoGatherer::translateDriveName(), trimmed(), tryDriveUNCFallback(), QSpinBoxValidator::validate(), QSettingsPrivate::variantToString(), QTextOdfWriter::writeInlineCharacter(), QX11Data::xdndMimeAtomForFormat(), and xdndObtainData().

Data * d

Definition: qstring.h:618

◆ startsWith() [1/4]

bool QString::startsWith	(	const QString &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns true if the string starts with s; otherwise returns false.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

    QString str = "Bananas";
    str.startsWith("Ban");     // returns true
    str.startsWith("Car");     // returns false

See also: endsWith()

Definition at line 3734 of file qstring.cpp.

 {
     return qt_starts_with(isNull() ? 0 : unicode(), size(),
                           s.isNull() ? 0 : s.unicode(), s.size(), cs);
 }

◆ startsWith() [2/4]

bool QString::startsWith	(	const QStringRef &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Returns true if the string starts with the string reference s; otherwise returns false.

Since: 4.8 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

If cs is Qt::CaseSensitive (default), the search is case sensitive; otherwise the search is case insensitive.

See also: endsWith()

Definition at line 3779 of file qstring.cpp.

 {
     return qt_starts_with(isNull() ? 0 : unicode(), size(),
                           s.isNull() ? 0 : s.unicode(), s.size(), cs);
 }

◆ startsWith() [3/4]

bool QString::startsWith	(	const QLatin1String &	s,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3743 of file qstring.cpp.

 {
     return qt_starts_with(isNull() ? 0 : unicode(), size(), s, cs);
 }

◆ startsWith() [4/4]

bool QString::startsWith	(	const QChar &	c,
		Qt::CaseSensitivity	cs = `Qt::CaseSensitive`
	)		const

Definition at line 3757 of file qstring.cpp.

 {
     return d->size
            && (cs == Qt::CaseSensitive
                ? d->data[0] == c
                : foldCase(d->data[0]) == foldCase(c.unicode()));
 }

◆ swap()

void QString::swap ( QString & other )

inline

Swaps string other with this string.

Since: 4.8

This operation is very fast and never fails.

Definition at line 101 of file qstring.h.

101 { qSwap(d, other.d); }

qSwap

void qSwap(T &value1, T &value2)

Definition: qglobal.h:2181

Referenced by QXmlTestLogger::addBenchmarkResult(), QTestLogger::addBenchmarkResult(), QIcdEngine::addConfiguration(), QAccessibleWidget::addControllingSignal(), QByteArray::append(), Maemo::appendVariantToDBusMessage(), QMetaObject::connectSlotsByName(), QStringRef::constData(), createImageNode(), QBBRootWindow::createWindowGroup(), QIcdEngine::deleteConfiguration(), QNetworkSessionPrivateImpl::do_open(), QIcdEngine::doRequestUpdate(), QDB2Result::exec(), QTest::formatResult(), fromLatin1(), QBBGLContext::getProcAddress(), QByteArray::indexOf(), QByteArray::insert(), QByteArray::lastIndexOf(), QPatternist::XQueryTokenizer::lookupKeyword(), QTest::mouseEvent(), QAccessibleWidget::navigate(), QLinuxFbIntegrationPrivate::openTty(), QLinuxFbScreenPrivate::openTty(), PvrEglScreen::openTty(), QByteArray::operator+=(), QSplitter::operator>>(), QHttpNetworkConnectionPrivate::prepareRequest(), QTest::printBenchmarkResult(), qstring_to_xtp(), qt_getLprPrinters(), qt_parseEtcLpPrinters(), qt_parsePrintersConf(), QAccessibleWidget::relationTo(), QByteArray::replace(), QSQLite2Result::reset(), QCharRef::row(), subControlLayout(), QImage::textList(), QUrlPrivate::toEncoded(), toStdString(), and write_xbm_image().

Data * d

Definition: qstring.h:618

◆ toAscii()

QByteArray QString::toAscii ( ) const

Returns an 8-bit representation of the string as a QByteArray.

If a codec has been set using QTextCodec::setCodecForCStrings(), it is used to convert Unicode to 8-bit char; otherwise this function does the same as toLatin1().

Note that, despite the name, this function does not necessarily return an US-ASCII (ANSI X3.4-1986) string and its result may not be US-ASCII compatible.

See also: fromAscii(), toLatin1(), toUtf8(), toLocal8Bit(), QTextCodec

Definition at line 4014 of file qstring.cpp.

 {
 #ifndef QT_NO_TEXTCODEC
     if (codecForCStrings)
         return codecForCStrings->fromUnicode(*this);
 #endif // QT_NO_TEXTCODEC
     return toLatin1();
 }

◆ toCaseFolded()

QString QString::toCaseFolded ( ) const

Returns the case folded equivalent of the string.

For most Unicode characters this is the same as toLower().

Definition at line 5441 of file qstring.cpp.

Referenced by qHash().

 {
     if (!d->size)
         return *this;
 
     const ushort *p = d->data;
     if (!p)
         return *this;
 
     const ushort *e = d->data + d->size;
 
     uint last = 0;
     while (p < e) {
         ushort folded = foldCase(*p, last);
         if (folded != *p) {
             QString s(*this);
             s.detach();
             ushort *pp = s.d->data + (p - d->data);
             const ushort *ppe = s.d->data + s.d->size;
             last = pp > s.d->data ? *(pp - 1) : 0;
             while (pp < ppe) {
                 *pp = foldCase(*pp, last);
                 ++pp;
             }
             return s;
         }
         p++;
     }
     return *this;
 }

◆ toDouble()

double QString::toDouble ( bool * ok = 0 ) const

Returns the string converted to a double value.

Returns 0.0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise *{ok} is set to true.

QString str = "1234.56";

double val = str.toDouble(); // val == 1234.56

Various string formats for floating point numbers can be converted to double values:

    bool ok;
    double d;
    d = QString( "1234.56e-02" ).toDouble(&ok); // ok == true, d == 12.3456

This function tries to interpret the string according to the current locale. The current locale is determined from the system at application startup and can be changed by calling QLocale::setDefault(). If the string cannot be interpreted according to the current locale, this function falls back on the "C" locale.

    QLocale::setDefault(QLocale::C);
    d = QString( "1234,56" ).toDouble(&ok); // ok == false
    d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56

    QLocale::setDefault(QLocale::German);
    d = QString( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
    d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56

Due to the ambiguity between the decimal point and thousands group separator in various locales, this function does not handle thousands group separators. If you need to convert such numbers, see QLocale::toDouble().

QLocale::setDefault(QLocale::C);

d = QString( "1234,56" ).toDouble(&ok); // ok == false

See also: number() QLocale::setDefault() QLocale::toDouble() trimmed()

Definition at line 6227 of file qstring.cpp.

Referenced by QTextHtmlParserNode::applyCssDeclarations(), QPSQLResult::data(), QMYSQLResult::data(), QLCDNumber::display(), QAxBase::dynamicCallHelper(), QPatternist::AbstractFloat< isDouble >::fromLexical(), QCss::ValueExtractor::lengthValue(), parseOpacity(), QDeclarativeStringConverters::pointFFromString(), QWSPcMouseHandlerPrivate::QWSPcMouseHandlerPrivate(), QCss::Declaration::realValue(), QDeclarativeStringConverters::rectFFromString(), QDoubleSpinBoxPrivate::round(), setFloatAttribute(), setWidthAttribute(), QDeclarativeStringConverters::sizeFFromString(), toFloat(), QDeclarativeStringConverters::variantFromString(), and QDeclarativeStringConverters::vector3DFromString().

 {
     bool my_ok;
     QLocale def_locale;
     double result = def_locale.d()->stringToDouble(*this, &my_ok, QLocalePrivate::FailOnGroupSeparators);
     if (my_ok) {
         if (ok != 0)
             *ok = true;
         return result;
     }
 
     QLocale c_locale(QLocale::C);
     return c_locale.d()->stringToDouble(*this, ok, QLocalePrivate::FailOnGroupSeparators);
 }

◆ toFloat()

float QString::toFloat ( bool * ok = 0 ) const

Definition at line 6257 of file qstring.cpp.

Referenced by QPrintPreviewDialogPrivate::_q_zoomFactorChanged(), and QVNCScreen::connect().

 {
     bool myOk;
     double d = toDouble(&myOk);
     if (!myOk || d > QT_MAX_FLOAT || d < -QT_MAX_FLOAT) {
         if (ok != 0)
             *ok = false;
         return 0.0;
     }
     if (ok != 0)
         *ok = true;
     return (float) d;
 }

◆ toInt()

int QString::toInt	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to an int using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    int hex = str.toInt(&ok, 16);       // hex == 255, ok == true
    int dec = str.toInt(&ok, 10);       // dec == 0, ok == false

See also: number(), toUInt(), toDouble()

Definition at line 6090 of file qstring.cpp.

Referenced by QFontDialogPrivate::_q_sizeChanged(), QFontDialogPrivate::_q_sizeHighlighted(), QHttpPrivate::_q_slotReadyRead(), QCalendarWidgetPrivate::_q_yearEditingFinished(), QTextHtmlParser::applyAttributes(), QTextCodec::availableMibs(), QCss::Declaration::borderImageValue(), EGLNullWSScreen::connect(), QQnxScreen::connect(), QVFbScreen::connect(), QVNCScreen::connect(), PvrEglScreen::connect(), QLinuxFbScreen::connect(), QLinuxFbIntegration::connect(), QDirectFBScreen::connect(), QMacPasteboardMimeVCard::convertFromMime(), QTextCodecPlugin::create(), QPatternist::AbstractDuration::create(), QPatternist::AbstractDateTime::create(), QMYSQLResult::data(), QKeySequencePrivate::decodeString(), QAxBase::dynamicCallHelper(), filterDisplayOffset(), filterTransformation(), QDate::fromString(), QTime::fromString(), QDateTime::fromString(), getDisplayId(), QSystemLocalePrivate::getLocaleInfo_int(), QBenchmarkValgrindUtils::getNewestFileName(), getNumTok(), QPSQLDriverPrivate::getPSQLVersion(), QBenchmarkValgrindUtils::haveValgrind(), QDeclarativeDebugServer::instance(), intValueHelper(), QAxServerBase::Invoke(), QLibrary::isLibrary(), QLibraryPrivate::isPlugin(), libGreaterThan(), QNativeSocketEnginePrivate::nativeBind(), QNativeSocketEnginePrivate::nativeConnect(), QNativeSocketEnginePrivate::nativeSendDatagram(), QWSServerPrivate::newMouseHandler(), QPSQLResult::numRowsAffected(), QSQLiteDriver::open(), QOCIDriver::open(), QScriptXmlParser::parse(), QDeclarativeDirParser::parse(), parseFont(), QDeclarativeStyledTextPrivate::parseFontAttributes(), QHttpResponseHeader::parseLine(), QPatternist::AbstractDateTime::parseZoneOffset(), QFtpPI::processReply(), QLinuxInputKeyboardHandler::QLinuxInputKeyboardHandler(), QLinuxInputMouseHandler::QLinuxInputMouseHandler(), qParseOpts(), qt_init(), qt_socket_setPortAndAddress(), QtWndProc(), QVFbIntegration::QVFbIntegration(), QVNCIntegration::QVNCIntegration(), QWSKbPrivate::QWSKbPrivate(), QWSLinuxInputKbPrivate::QWSLinuxInputKbPrivate(), QWSLinuxInputMousePrivate::QWSLinuxInputMousePrivate(), QWSPcMouseHandlerPrivate::QWSPcMouseHandlerPrivate(), QWSTslibMouseHandlerPrivate::QWSTslibMouseHandlerPrivate(), QWSTtyKbPrivate::QWSTtyKbPrivate(), read_xbm_header(), setIntAttribute(), setIntOption(), QHttpSocketEngine::slotSocketReadNotification(), QSystemLocalePrivate::toCurrencyString(), QPatternist::XQueryTokenizer::tokenizeCharacterReference(), tokenUntil(), QDateTime::toString(), and vsprintf().

 {
     qint64 v = toLongLong(ok, base);
     if (v < INT_MIN || v > INT_MAX) {
         if (ok)
             *ok = false;
         v = 0;
     }
     return v;
 }

◆ toLatin1()

QByteArray QString::toLatin1 ( ) const

Returns a Latin-1 representation of the string as a QByteArray.

The returned byte array is undefined if the string contains non-Latin1 characters. Those characters may be suppressed or replaced with a question mark.

See also: fromLatin1(), toAscii(), toUtf8(), toLocal8Bit(), QTextCodec

Definition at line 3993 of file qstring.cpp.

 {
     return toLatin1_helper(unicode(), length());
 }

◆ toLocal8Bit()

QByteArray QString::toLocal8Bit ( ) const

Returns the local 8-bit representation of the string as a QByteArray.

The returned byte array is undefined if the string contains characters not supported by the local 8-bit encoding.

QTextCodec::codecForLocale() is used to perform the conversion from Unicode. If the locale encoding could not be determined, this function does the same as toLatin1().

If this string contains any characters that cannot be encoded in the locale, the returned byte array is undefined. Those characters may be suppressed or replaced by another.

See also: fromLocal8Bit(), toAscii(), toLatin1(), toUtf8(), QTextCodec

Definition at line 4049 of file qstring.cpp.

Referenced by QProcessPrivate::_q_notified(), QBasicUnixFontDatabase::addApplicationFont(), QLayout::addChildLayout(), QGraphicsLayoutPrivate::addChildLayoutItem(), QLayout::addChildWidget(), QSqlDatabasePrivate::addDatabase(), QZipWriterPrivate::addEntry(), QResource::addSearchPath(), QGridLayout::addWidget(), arg(), QAudioDeviceInfoInternal::availableDevices(), QCoreApplicationPrivate::checkReceiverThread(), checkWidget(), QPdfBaseEnginePrivate::closePrintDevice(), QDirectFBScreen::connect(), QWSSocket::connectToLocalFile(), QDeclarativeEnginePrivate::consoleLog(), QStringRef::constData(), QWindowsMimeText::convertFromMime(), QWindowsMimeURI::convertFromMime(), QMacPasteboardMimeVCard::convertFromMime(), QLayoutPrivate::createSpacerItem(), QGraphicsAnchorLayoutPrivate::dumpGraph(), dumpRecursive(), QApplicationPrivate::enterModal_sys(), err_info_about_objects(), QSqlQuery::exec(), QPSQLDriverPrivate::exec(), QMinimalWindowSurface::flush(), QTextStreamPrivate::flushWriteBuffer(), QFontconfigDatabase::fontEngine(), QBasicUnixFontDatabase::fontEngine(), QDirectFBPixmapData::fromFile(), QDirectFbBlitterPlatformPixmap::fromFile(), QApplicationPrivate::globalEventProcessor(), QAuServerNAS::init(), QWSServerSocket::init(), init_platform(), initializeDb(), QDirectFbIntegration::initializeDirectFB(), QSqlDatabasePrivate::invalidateDb(), QApplicationPrivate::leaveModal_sys(), loadSingleEngine(), locale_encode(), QXlibMime::mimeDataForAtom(), multiArg(), QIBaseDriver::open(), QAudioDeviceInfoInternal::open(), QTDSDriver::open(), QMYSQLDriver::open(), QAudioInputPrivate::open(), QPSQLDriver::open(), QWSTslibMouseHandlerPrivate::open(), QAudioOutputPrivate::open(), QDeclarativeInfo::operator<<(), QProcessEnvironmentPrivate::OrderedMutexLocker::OrderedMutexLocker(), QAuServerNAS::play(), QSqlQuery::prepare(), qDecodeOCIType(), qErrnoWarning(), QTest::qExec(), qGetInterfaceType(), QLayout::QLayout(), QLinuxInputKeyboardHandler::QLinuxInputKeyboardHandler(), QLinuxInputMouseHandler::QLinuxInputMouseHandler(), QLock::QLock(), qParseOpts(), QTest::qSignalDumperCallback(), QTest::qSignalDumperCallbackSlot(), qSqlWarning(), qt_adopted_thread_watcher_function(), qt_message(), qt_nograb(), qt_tildeExpansion(), QByteArray::qvsnprintf(), qws_dataDir(), QWSLinuxInputKbPrivate::QWSLinuxInputKbPrivate(), QWSLinuxInputMousePrivate::QWSLinuxInputMousePrivate(), QWSTtyKbPrivate::QWSTtyKbPrivate(), QWSUmKeyboardHandlerPrivate::QWSUmKeyboardHandlerPrivate(), QMYSQLDriver::record(), QResource::registerResource(), QCoreApplicationPrivate::removePostedEvent(), QGraphicsLayoutPrivate::reparentChildItems(), QTDSResult::reset(), QToolBarAreaLayout::saveState(), QWidget::setLayout(), setOptionFlag(), QPrinter::setPrinterName(), QThreadPrivate::start(), QProcessPrivate::startDetached(), QProcessPrivate::startProcess(), QIBaseDriver::subscribeToNotificationImplementation(), QAudioDeviceInfoInternal::testSettings(), WinMain(), QPatternist::ColorOutputPrivate::write(), and QX11Data::xdndMimeDataForAtom().

 {
 #ifndef QT_NO_TEXTCODEC
     if (QTextCodec::codecForLocale())
         return QTextCodec::codecForLocale()->fromUnicode(*this);
 #endif // QT_NO_TEXTCODEC
     return toLatin1();
 }

◆ toLong()

long QString::toLong	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to a long using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    long hex = str.toLong(&ok, 16);     // hex == 255, ok == true
    long dec = str.toLong(&ok, 10);     // dec == 0, ok == false

See also: number(), toULong(), toInt()

Definition at line 6027 of file qstring.cpp.

 {
     qint64 v = toLongLong(ok, base);
     if (v < LONG_MIN || v > LONG_MAX) {
         if (ok)
             *ok = false;
         v = 0;
     }
     return (long)v;
 }

◆ toLongLong()

qint64 QString::toLongLong	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to a long long using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    qint64 hex = str.toLongLong(&ok, 16);      // hex == 255, ok == true
    qint64 dec = str.toLongLong(&ok, 10);      // dec == 0, ok == false

See also: number(), toULongLong(), toInt()

Definition at line 5943 of file qstring.cpp.

Referenced by _q_parseDosDir(), _q_parseUnixDir(), QPSQLResult::data(), QMYSQLResult::data(), QBenchmarkValgrindUtils::extractResult(), QPatternist::Integer::fromLexical(), QPatternist::DerivedInteger< DerivedType >::fromLexical(), QNetworkAccessFtpBackend::ftpRawCommandReply(), QFtpPI::processReply(), toInt(), toLong(), and toShort().

 {
 #if defined(QT_CHECK_RANGE)
     if (base != 0 && (base < 2 || base > 36)) {
         qWarning("QString::toLongLong: Invalid base (%d)", base);
         base = 10;
     }
 #endif
 
     bool my_ok;
     QLocale def_locale;
     qint64 result = def_locale.d()->stringToLongLong(*this, base, &my_ok, QLocalePrivate::FailOnGroupSeparators);
     if (my_ok) {
         if (ok != 0)
             *ok = true;
         return result;
     }
 
     QLocale c_locale(QLocale::C);
     return c_locale.d()->stringToLongLong(*this, base, ok, QLocalePrivate::FailOnGroupSeparators);
 }

◆ toLower()

QString QString::toLower ( ) const

Returns a lowercase copy of the string.

QString str = "Qt by NOKIA";

str = str.toLower(); // str == "qt by nokia"

The case conversion will always happen in the 'C' locale. For locale dependent case folding use QLocale::toLower()

See also: toUpper(), QLocale::toLower()

Definition at line 5389 of file qstring.cpp.

 {
     const ushort *p = d->data;
     if (!p)
         return *this;
     if (!d->size)
         return *this;
 
     const ushort *e = d->data + d->size;
 
     // this avoids one out of bounds check in the loop
     if (QChar(*p).isLowSurrogate())
         ++p;
 
     while (p != e) {
         uint c = *p;
         if (QChar(c).isLowSurrogate() && QChar(*(p - 1)).isHighSurrogate())
             c = QChar::surrogateToUcs4(*(p - 1), c);
         const QUnicodeTables::Properties *prop = qGetProp(c);
         if (prop->lowerCaseDiff || prop->lowerCaseSpecial) {
             QString s(d->size, Qt::Uninitialized);
             memcpy(s.d->data, d->data, (p - d->data)*sizeof(ushort));
             ushort *pp = s.d->data + (p - d->data);
             while (p < e) {
                 uint c = *p;
                 if (QChar(c).isLowSurrogate() && QChar(*(p - 1)).isHighSurrogate())
                     c = QChar::surrogateToUcs4(*(p - 1), c);
                 prop = qGetProp(c);
                 if (prop->lowerCaseSpecial) {
                     int pos = pp - s.d->data;
                     s.resize(s.d->size + SPECIAL_CASE_MAX_LEN);
                     pp = s.d->data + pos;
                     const ushort *specialCase = specialCaseMap + prop->lowerCaseDiff;
                     while (*specialCase)
                         *pp++ = *specialCase++;
                 } else {
                     *pp++ = *p + prop->lowerCaseDiff;
                 }
                 ++p;
             }
             s.truncate(pp - s.d->data);
             return s;
         }
         ++p;
     }
     return *this;
 }

◆ toShort()

short QString::toShort	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to a short using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    short hex = str.toShort(&ok, 16);   // hex == 255, ok == true
    short dec = str.toShort(&ok, 10);   // dec == 0, ok == false

See also: number(), toUShort(), toInt()

Definition at line 6150 of file qstring.cpp.

 {
     long v = toLongLong(ok, base);
     if (v < SHRT_MIN || v > SHRT_MAX) {
         if (ok)
             *ok = false;
         v = 0;
     }
     return (short)v;
 }

◆ toStdString()

std::string QString::toStdString ( ) const

inline

Returns a std::string object with the data contained in this QString.

The Unicode data is converted into 8-bit characters using the toAscii() function.

This operator is mostly useful to pass a QString to a function that accepts a std::string object.

If the QString contains Unicode characters that the QTextCodec::codecForCStrings() codec cannot handle, using this operator can lead to loss of information.

This operator is only available if Qt is configured with STL compatibility enabled.

See also: toAscii(), toLatin1(), toUtf8(), toLocal8Bit()

Definition at line 1044 of file qstring.h.

1045 { const QByteArray asc = toAscii(); return std::string(asc.constData(), asc.length()); }

QByteArray

The QByteArray class provides an array of bytes.

Definition: qbytearray.h:135

QByteArray::length

int length() const

Same as size().

Definition: qbytearray.h:356

Referenced by colorFromName(), QHttpHeader::contentLength(), QMYSQLResult::data(), QNativeWifiEngine::disconnectFromId(), QSystemLocalePrivate::firstDayOfWeek(), QLibraryPrivate::isPlugin(), QNlaThread::parseBlob(), QTextHtmlParser::parseEntity(), parseIp4(), parseIp6(), QXmlSimpleReaderPrivate::parseReference(), parseServerList(), QHostAddress::parseSubnet(), qExtractSecurityPolicyFromString(), NamedNodeMapClass::queryProperty(), NodeListClass::queryProperty(), and QXmlStreamReaderPrivate::resolveCharRef().

const char * constData() const

Returns a pointer to the data stored in the byte array.

Definition: qbytearray.h:433

QString::toAscii

QByteArray toAscii() const Q_REQUIRED_RESULT

Returns an 8-bit representation of the string as a QByteArray.

Definition: qstring.cpp:4014

◆ toStdWString()

QStdWString QString::toStdWString ( ) const

inline

Returns a std::wstring object with the data contained in this QString.

The std::wstring is encoded in utf16 on platforms where wchar_t is 2 bytes wide (e.g. windows) and in ucs4 on platforms where wchar_t is 4 bytes wide (most Unix systems).

This operator is mostly useful to pass a QString to a function that accepts a std::wstring object.

This operator is only available if Qt is configured with STL compatibility enabled.

See also: utf16(), toAscii(), toLatin1(), toUtf8(), toLocal8Bit()

Definition at line 1051 of file qstring.h.

 {
     QStdWString str;
     str.resize(length());
 
 #if defined(_MSC_VER) && _MSC_VER >= 1400
     // VS2005 crashes if the string is empty
     if (!length())
         return str;
 #endif
 
     str.resize(toWCharArray(&(*str.begin())));
     return str;
 }

◆ toUcs4()

QVector< uint > QString::toUcs4 ( ) const

Returns a UCS-4/UTF-32 representation of the string as a QVector<uint>.

Since: 4.2

UCS-4 is a Unicode codec and is lossless. All characters from this string can be encoded in UCS-4. The vector is not null terminated.

See also: fromUtf8(), toAscii(), toLatin1(), toLocal8Bit(), QTextCodec, fromUcs4(), toWCharArray()

Definition at line 4095 of file qstring.cpp.

Referenced by QStringRef::constData(), and toSQLTCHAR().

 {
     QVector<uint> v(length());
     uint *a = v.data();
     int len = toUcs4_helper<uint>(utf16(), length(), a);
     v.resize(len);
     return v;
 }

◆ toUInt()

uint QString::toUInt	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to an unsigned int using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    uint hex = str.toUInt(&ok, 16);     // hex == 255, ok == true
    uint dec = str.toUInt(&ok, 10);     // dec == 0, ok == false

See also: number(), toInt()

Definition at line 6120 of file qstring.cpp.

 {
     quint64 v = toULongLong(ok, base);
     if (v > UINT_MAX) {
         if (ok)
             *ok = false;
         v = 0;
     }
     return (uint)v;
 }

◆ toULong()

ulong QString::toULong	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to an unsigned long using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    ulong hex = str.toULong(&ok, 16);   // hex == 255, ok == true
    ulong dec = str.toULong(&ok, 10);   // dec == 0, ok == false

See also: number()

Definition at line 6059 of file qstring.cpp.

 {
     quint64 v = toULongLong(ok, base);
     if (v > ULONG_MAX) {
         if (ok)
             *ok = false;
         v = 0;
     }
     return (ulong)v;
 }

◆ toULongLong()

quint64 QString::toULongLong	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to an unsigned long long using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    quint64 hex = str.toULongLong(&ok, 16);    // hex == 255, ok == true
    quint64 dec = str.toULongLong(&ok, 10);    // dec == 0, ok == false

See also: number(), toLongLong()

Definition at line 5984 of file qstring.cpp.

Referenced by QPSQLResult::data(), QMYSQLResult::data(), QPatternist::DerivedInteger< DerivedType >::fromLexical(), toUInt(), toULong(), and toUShort().

 {
 #if defined(QT_CHECK_RANGE)
     if (base != 0 && (base < 2 || base > 36)) {
         qWarning("QString::toULongLong: Invalid base (%d)", base);
         base = 10;
     }
 #endif
 
     bool my_ok;
     QLocale def_locale;
     quint64 result = def_locale.d()->stringToUnsLongLong(*this, base, &my_ok, QLocalePrivate::FailOnGroupSeparators);
     if (my_ok) {
         if (ok != 0)
             *ok = true;
         return result;
     }
 
     QLocale c_locale(QLocale::C);
     return c_locale.d()->stringToUnsLongLong(*this, base, ok, QLocalePrivate::FailOnGroupSeparators);
 }

◆ toUpper()

QString QString::toUpper ( ) const

Returns an uppercase copy of the string.

QString str = "TeXt";

str = str.toUpper(); // str == "TEXT"

The case conversion will always happen in the 'C' locale. For locale dependent case folding use QLocale::toUpper()

See also: toLower(), QLocale::toLower()

Definition at line 5483 of file qstring.cpp.

Referenced by _q_parseUnixDir(), QDeclarativeEngineDebugService::buildObjectDump(), classIDL(), QLocalePrivate::codeToCountry(), QLocalePrivate::dateTimeToString(), QKeySequencePrivate::decodeString(), QPatternist::NormalizeUnicodeFN::determineNormalizationForm(), QLocalePrivate::doubleToString(), DumpIDL(), QPatternist::AbstractFloat< isDouble >::fromLexical(), getFmtString(), QNativeWifiEngine::getInterfaceFromId(), QFileIconProviderPrivate::getWinIcon(), QSqlRecord::indexOf(), QMenuBar::keyPressEvent(), QFSFileEnginePrivate::longFileName(), QLocalePrivate::longLongToString(), nameToType(), QFileSystemModelPrivate::node(), QIBaseDriver::open(), QSplitter::operator>>(), QDB2Driver::primaryIndex(), QIBaseDriver::primaryIndex(), QOCIDriver::primaryIndex(), qCreatev2Hash(), qGetODBCVersion(), qmlxmlhttprequest_open(), qmlxmlhttprequest_setRequestHeader(), qStringFromUcs2Le(), rasterFallbacksMask(), MetaObjectGenerator::readClassInfo(), MetaObjectGenerator::readEventInfo(), MetaObjectGenerator::readInterfaceInfo(), QIBaseResult::record(), QDB2Driver::record(), QIBaseDriver::record(), QOCIDriver::record(), QInternalMimeData::renderDataHelper(), QDB2Driver::tables(), QOCIDriver::tables(), QLocale::toUpper(), QLocalePrivate::unsLongLongToString(), UpdateRegistry(), and xdndObtainData().

 {
     const ushort *p = d->data;
     if (!p)
         return *this;
     if (!d->size)
         return *this;
 
     const ushort *e = d->data + d->size;
 
     // this avoids one out of bounds check in the loop
     if (QChar(*p).isLowSurrogate())
         ++p;
 
     while (p != e) {
         uint c = *p;
         if (QChar(c).isLowSurrogate() && QChar(*(p - 1)).isHighSurrogate())
             c = QChar::surrogateToUcs4(*(p - 1), c);
         const QUnicodeTables::Properties *prop = qGetProp(c);
         if (prop->upperCaseDiff || prop->upperCaseSpecial) {
             QString s(d->size, Qt::Uninitialized);
             memcpy(s.d->data, d->data, (p - d->data)*sizeof(ushort));
             ushort *pp = s.d->data + (p - d->data);
             while (p < e) {
                 uint c = *p;
                 if (QChar(c).isLowSurrogate() && QChar(*(p - 1)).isHighSurrogate())
                     c = QChar::surrogateToUcs4(*(p - 1), c);
                 prop = qGetProp(c);
                 if (prop->upperCaseSpecial) {
                     int pos = pp - s.d->data;
                     s.resize(s.d->size + SPECIAL_CASE_MAX_LEN);
                     pp = s.d->data + pos;
                     const ushort *specialCase = specialCaseMap + prop->upperCaseDiff;
                     while (*specialCase)
                         *pp++ = *specialCase++;
                 } else {
                     *pp++ = *p + prop->upperCaseDiff;
                 }
                 ++p;
             }
             s.truncate(pp - s.d->data);
             return s;
         }
         ++p;
     }
     return *this;
 }

◆ toUShort()

ushort QString::toUShort	(	bool *	ok = `0`,
		int	base = `10`
	)		const

Returns the string converted to an unsigned short using base base, which is 10 by default and must be between 2 and 36, or 0.

Returns 0 if the conversion fails.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true.

If base is 0, the C language convention is used: If the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise, base 10 is used.

Example:

    QString str = "FF";
    bool ok;
    ushort hex = str.toUShort(&ok, 16);     // hex == 255, ok == true
    ushort dec = str.toUShort(&ok, 10);     // dec == 0, ok == false

See also: number(), toShort()

Definition at line 6180 of file qstring.cpp.

Referenced by QNativeWifiEngine::disconnectFromId(), and QCss::Scanner::preprocess().

 {
     ulong v = toULongLong(ok, base);
     if (v > USHRT_MAX) {
         if (ok)
             *ok = false;
         v = 0;
     }
     return (ushort)v;
 }

◆ toUtf8()

QByteArray QString::toUtf8 ( ) const

Returns a UTF-8 representation of the string as a QByteArray.

UTF-8 is a Unicode codec and can represent all characters in a Unicode string like QString.

However, in the Unicode range, there are certain codepoints that are not considered characters. The Unicode standard reserves the last two codepoints in each Unicode Plane (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE, etc.), as well as 16 codepoints in the range U+FDD0..U+FDDF, inclusive, as non-characters. If any of those appear in the string, they may be discarded and will not appear in the UTF-8 representation, or they may be replaced by one or more replacement characters.

See also: fromUtf8(), toAscii(), toLatin1(), toLocal8Bit(), QTextCodec

Definition at line 4074 of file qstring.cpp.

Referenced by QDBusConnectionPrivate::activateCall(), QDeclarativeImportsPrivate::add(), QZipWriterPrivate::addEntry(), QDeclarativeXMLHttpRequest::addHeader(), QDnotifyFileSystemWatcherEngine::addPaths(), QDBusMarshaller::append(), Maemo::appendVariantToDBusMessage(), QApplicationPrivate::applyX11SpecificCommandLineArguments(), QDeclarativeEnginePrivate::atob(), QJSDebuggerAgent::backtrace(), QDeclarativeEnginePrivate::btoa(), QDeclarativeCompiler::buildDynamicMeta(), QAuthenticatorPrivate::calculateResponse(), QFileSystemEngine::canonicalName(), QDeclarativePropertyMap::clear(), QDeclarativeCompiler::compile(), QDeclarativeCompiler::compileAlias(), QDeclarativeListModelParser::compileProperty(), QDBusConnection::connectToBus(), QDBusConnection::connectToPeer(), QStringRef::constData(), QDeclarativeContext::contextProperty(), QMacPasteboardMimeAny::convertFromMime(), QWindowsMimeHtml::convertFromMime(), QMacPasteboardMimeVCard::convertFromMime(), QWindowsMimeText::convertToMime(), QDeclarativePropertyCache::create(), QDeclarativePathView::createdItem(), QPatternist::ExpressionFactory::createExpression(), QDeclarativeEnginePrivate::createQmlObject(), QDeclarativeXmlQueryEngine::doQueryJob(), QPSPrintEnginePrivate::emitHeader(), encodeString(), QDeclarativeObjectMethodScriptClass::enumType(), QODBCResult::exec(), QPSQLDriverPrivate::exec(), QFontconfigDatabase::fallbacksForFamily(), QWSSoundServerPrivate::feedDevice(), QDeclarativeXMLHttpRequest::findTextCodec(), QFontconfigDatabase::fontEngine(), QBBClipboard::MimeData::formats(), fromScriptValue(), QUrl::fromUserInput(), Maemo::GConfItemFast::getEntries(), getFcPattern(), getImage(), QDeclarativePathViewPrivate::getItem(), getMacLocaleName(), getPixmap(), QFileIconProviderPrivate::getWinIcon(), QBBClipboard::MimeData::hasFormat(), QDeclarativeXMLHttpRequest::header(), QDeclarativeImportDatabase::importPlugin(), QDeclarativePropertyPrivate::initProperty(), QDeclarativePropertyMap::insert(), QScript::integerFromString(), QTextLine::layout_helper(), QLibraryPrivate::load_sys(), locale_encode(), QDBusMessagePrivate::makeLocal(), QSharedMemoryPrivate::makePlatformSafeKey(), QDeclarativeEnginePrivate::md5(), navigatorInvoke(), QSQLiteDriver::open(), QODBCDriver::open(), QDeclarativePropertyMap::operator[](), QDeclarativeBindingCompilerPrivate::parseName(), QODBCResult::prepare(), QODBCDriver::primaryIndex(), QFontEngineMac::properties(), QFontEngine::properties(), QTextStreamPrivate::putString(), QDBusError::QDBusError(), qDBusPropertyGet(), qDBusPropertySet(), QDBusServer::QDBusServer(), qExtractSecurityPolicyFromString(), qmlsqldatabase_open_sync(), qmlxmlhttprequest_open(), qmlxmlhttprequest_send(), qstring_to_xtp(), qt_addPatternProps(), qt_mac_create_fsref(), qt_mac_execute_apple_script(), QDeclarativeValueTypeScriptClass::queryProperty(), QDeclarativeTypeNameScriptClass::queryProperty(), QODBCDriver::record(), registerFont(), QSQLite2Result::reset(), QODBCResult::reset(), QDeclarativeTypeData::resolveTypes(), QTextBrowserPrivate::resolveUrl(), QBBClipboard::MimeData::retrieveData(), QMimeDataPrivate::retrieveTypedData(), QWSSoundServerClient::sendClientMessage(), set_text(), QXmlQuery::setFocus(), QBBClipboard::setMimeData(), ModelNode::setObjectValue(), ModelNode::setProperty(), QXmlQuery::setQuery(), QXcbWindow::setWindowTitle(), QWidgetPrivate::setWindowTitle_sys(), sm_setProperty(), QProcessPrivate::startDetached(), QProcessPrivate::startProcess(), QDeclarativeVisualDataModel::stringValue(), QODBCDriver::tables(), QDeclarativeCompiler::testQualifiedEnumAssignment(), QDomDocument::toByteArray(), QDBusMessagePrivate::toDBusMessage(), QUrlPrivate::toEncoded(), toPercentEncodingHelper(), toSQLTCHAR(), QDeclarativePathViewPrivate::updateItem(), QDeclarativePropertyMap::value(), QTextOdfWriter::writeInlineCharacter(), and xic_draw_callback().

 {
     if (isNull())
         return QByteArray();
 
     return QUtf8::convertFromUnicode(constData(), length(), 0);
 }

◆ toWCharArray()

int QString::toWCharArray ( wchar_t * array ) const

Fills the array with the data contained in this QString object.

Since: 4.2

The array is encoded in utf16 on platforms where wchar_t is 2 bytes wide (e.g. windows) and in ucs4 on platforms where wchar_t is 4 bytes wide (most Unix systems).

array has to be allocated by the caller and contain enough space to hold the complete string (allocating the array with the same length as the string is always sufficient).

returns the actual length of the string in array.

Note: This function does not append a null character to the array.

See also: utf16(), toUcs4(), toAscii(), toLatin1(), toUtf8(), toLocal8Bit(), toStdWString()

Definition at line 1086 of file qstring.cpp.

Referenced by toStdWString().

 {
     if (sizeof(wchar_t) == sizeof(QChar)) {
         memcpy(array, utf16(), sizeof(wchar_t)*length());
         return length();
     } else {
         return toUcs4_helper<wchar_t>(utf16(), length(), array);
     }
 }

◆ trimmed()

QString QString::trimmed ( ) const

Returns a string that has whitespace removed from the start and the end.

Whitespace means any character for which QChar::isSpace() returns true. This includes the ASCII characters '\t', '\n', '\v', '\f', '\r', and ' '.

Example:

    QString str = "  lots\t of\nwhitespace\r\n ";
    str = str.trimmed();
    // str == "lots\t of\nwhitespace"

Unlike simplified(), trimmed() leaves internal whitespace alone.

See also: simplified()

Definition at line 4506 of file qstring.cpp.

Referenced by QFtpPrivate::_q_startNextCommand(), QTransformedScreen::connect(), QHttpHeader::contentType(), createImageNode(), createSvgNode(), QPatternist::NormalizeUnicodeFN::determineNormalizationForm(), QAxBase::dynamicCallHelper(), QPatternist::NCNameConstructor::evaluateSingleton(), QSymSQLResult::exec(), QSqlQuery::exec(), familyList(), QDateTimeParser::findAmPm(), QIconLoader::findIconHelper(), fontPath(), fractionDigitsForDecimal(), QPatternist::HexBinary::fromLexical(), QPatternist::Decimal::fromLexical(), QPatternist::Boolean::fromLexical(), QPatternist::DerivedString< TypeToken >::fromLexical(), QSslCertificate::fromPath(), QUrl::fromUserInput(), QDeclarativeCompiler::genObjectBody(), getLocations(), QGtkStylePrivate::getThemeName(), QPatternist::XSLTTokenizer::insideSequenceConstructor(), QDeclarativeJS::integerFromString(), QScript::integerFromString(), Text::isElementContentWhitespace(), QMetaEnum::keysToValue(), launchWebBrowser(), QHttpHeader::parse(), parseAnimateColorNode(), parseAnimateTransformNode(), QTextHtmlParser::parseCloseTag(), parseColorValue(), parseCompOp(), QFtpDTP::parseDir(), parseFont(), parseLength(), QHttpHeader::parseLine(), parseOpacity(), parseOthers(), QDeclarativeGridScaledImage::QDeclarativeGridScaledImage(), qt_error_string(), qt_get_screen(), qt_mac_extract_filter(), qt_parsePrintcap(), qt_parseSpoolInterface(), qt_set_x11_resources(), qt_strippedText(), QFtp::rawCommand(), QPatternist::XSLTTokenizer::readAlternativeAttribute(), QNSOpenSavePanelDelegate::removeExtensions:, QPatternist::XsdValidatingInstanceReader::selectNodeSets(), QUrlPrivate::setAuthority(), QScriptDebuggerLocalsModel::setData(), QUrl::setUserInfo(), setWidthAttribute(), standardLibraryErrorString(), QLocalePrivate::stringToDouble(), QLocalePrivate::stringToLongLong(), QLocalePrivate::stringToUnsLongLong(), QAbstractSpinBoxPrivate::stripped(), QCoreFuriCuri::timerEvent(), QDeclarativePropertyAction::transition(), QDeclarativePropertyAnimation::transition(), trimmed(), QAbstractXmlReceiver::whitespaceOnly(), QPatternist::AccelTreeBuilder< true >::whitespaceOnly(), and QPatternist::QAbstractXmlReceiver::whitespaceOnly().

 {
     if (d->size == 0)
         return *this;
     const QChar *s = (const QChar*)d->data;
     if (!s->isSpace() && !s[d->size-1].isSpace())
         return *this;
     int start = 0;
     int end = d->size - 1;
     while (start<=end && s[start].isSpace())  // skip white space from start
         start++;
     if (start <= end) {                          // only white space
         while (end && s[end].isSpace())           // skip white space from end
             end--;
     }
     int l = end - start + 1;
     if (l <= 0) {
         shared_empty.ref.ref();
         return QString(&shared_empty, 0);
     }
     return QString(s + start, l);
 }

◆ truncate()

void QString::truncate ( int position )

Truncates the string at the given position index.

If the specified position index is beyond the end of the string, nothing happens.

Example:

    QString str = "Vladivostok";
    str.truncate(4);
    // str == "Vlad"

If position is negative, it is equivalent to passing zero.

See also: chop(), resize(), left()

Definition at line 4603 of file qstring.cpp.

Referenced by QHttpPrivate::_q_slotReadyRead(), QCoreApplicationPrivate::appendApplicationPathToLibraryPaths(), QDBusAbstractInterface::callWithArgumentList(), QVNCScreen::connect(), QTransformedScreen::connect(), QWindowsMimeText::convertFromMime(), QBuiltInMimes::convertFromMime(), QUtf8::convertToUnicode(), QUtf16::convertToUnicode(), QUtf32::convertToUnicode(), QLocalePrivate::doubleToString(), QLCDNumberPrivate::drawString(), errorCodeToString(), QPatternist::TranslateFN::evaluateSingleton(), QWSSoundServerPrivate::feedDevice(), find_translation(), QSqlDriver::formatValue(), QProcessEnvironmentPrivate::fromList(), QDBusConnectionPrivate::handleSignal(), iniChopTrailingSpaces(), QSettingsPrivate::normalizedKey(), parse_locale_tag(), QDateTimeParser::parseSection(), QHostAddress::parseSubnet(), QSettingsPrivate::processChild(), qt_get_screen(), qt_nameprep(), QDirPrivate::setPath(), simplified(), QAbstractSpinBox::sizeHint(), toLower(), toPunycodeHelper(), QKeySequence::toString(), toUpper(), QWSSoundServerClient::tryReadCommand(), vsprintf(), and write_xpm_image().

 {
     if (pos < d->size)
         resize(pos);
 }

◆ unicode()

const QChar * QString::unicode ( ) const

inline

Returns a '\0'-terminated Unicode representation of the string.

The result remains valid until the string is modified.

See also: utf16()

Definition at line 706 of file qstring.h.

Referenced by QXmlStreamPrivateTagStack::addToStringStorage(), QStringRef::appendTo(), bidiItemize(), QFontMetrics::charWidth(), QDir::cleanPath(), QLocalePrivate::codeToCountry(), QLocalePrivate::codeToLanguage(), compare(), QStringRef::constData(), QWindowsMimeText::convertFromMime(), QBuiltInMimes::convertFromMime(), QIsciiCodec::convertToUnicode(), QUtf8::convertToUnicode(), QUtf16::convertToUnicode(), QUtf32::convertToUnicode(), count(), QStringRef::count(), QStringRef::data(), QKeySequencePrivate::decodeString(), QLocalePrivate::doubleToString(), QTextLine::draw(), drawMenuText(), QPainter::drawText(), DumpIDL(), QAxBase::dynamicCallHelper(), endsWith(), QStringRef::endsWith(), QRegExp::exactMatch(), findArgEscapes(), QAxServerBase::GetCurFile(), getEnglishName(), QRegExpEngine::goodStringMatch(), QStringMatcher::indexIn(), QRegExp::indexIn(), indexOf(), QStringRef::indexOf(), QFileSystemEntry::isAbsolute(), QFileSystemEntry::isRelative(), QDBusUtil::isValidBusName(), QDBusUtil::isValidMemberName(), QDBusUtil::isValidPartOfObjectPath(), QDBusUtil::isValidUniqueConnectionName(), QTextEngine::itemize(), QRegExp::lastIndexIn(), lastIndexOf(), QStringRef::lastIndexOf(), localizedName(), QLocalePrivate::longLongToString(), QScriptEnginePrivate::newRegExp(), nextDotDelimiter(), QLocalePrivate::numberToCLocale(), operator<<(), QStringRef::operator==(), QTextDocumentPrivate::plainText(), qHash(), QRegExpEngine::QRegExpEngine(), QStringMatcher::QStringMatcher(), QStringToBSTR(), QStringToOLESTR(), qt_keyrelease_scanner(), qt_mac_to_pascal_string(), qt_string_count(), qt_string_normalize(), QUuid::QUuid(), qwsSetClipboardText(), replace(), replaceArgEscapes(), QCharRef::row(), section(), QStringMatcher::setCaseSensitivity(), QScript::Lexer::setCode(), QDeclarativeJS::Lexer::setCode(), QXmlInputSource::setData(), QWSPlaySoundCommand::setFileName(), QWSQCopSendCommand::setMessage(), QStringMatcher::setPattern(), startsWith(), QStringRef::startsWith(), QTextBoundaryFinder::string(), QStringRef::toAscii(), toLatin1(), QStringRef::toLatin1(), QStringRef::toLocal8Bit(), toSQLTCHAR(), QUuid::toString(), QStringRef::toUcs4(), QXlibKeyboard::translateKeySym(), QXcbKeyboard::translateKeySym(), translateKeySym(), QStringRef::unicode(), QLocalePrivate::unsLongLongToString(), and wc2rx().

707 { return reinterpret_cast<const QChar*>(d->data); }

The QChar class provides a 16-bit Unicode character.

Definition: qchar.h:72

Data * d

Definition: qstring.h:618

Referenced by QAxScriptEngine::addItem(), QLocalServerPrivate::addListener(), QFileSystemModelPrivate::addNode(), QOCIResultPrivate::bindValue(), QLastResortMimes::canConvertToMime(), QNativeWifiEngine::connectToId(), QWindowsMimeURI::convertFromMime(), QLastResortMimes::convertToMime(), QAxServerBase::create(), QAxServerBase::createMenu(), createOrOpenKey(), QAxServerBase::createPopup(), deleteChildGroups(), QAxMetaObject::dispIDofName(), QVistaHelper::drawTitleText(), QSQLiteResult::exec(), QOCICols::execBatch(), expandEnvStrings(), QFileSystemEngine::fillMetaData(), QFileSystemEngine::fillPermissions(), QSystemTrayIconSys::findTrayGeometry(), generateName(), getEnglishName(), getFindData(), XPThemeData::handle(), QFileIconProvider::icon(), QWindowsSystemProxy::init(), QAxScriptEngine::initialize(), QAxBase::initializeRemote(), isDirPath(), launchWebBrowser(), QSystemLibrary::load(), QAxServerBase::Load(), loadEngine(), QFSFileEnginePrivate::longFileName(), QFileDialogPrivate::maxNameLength(), QFileSystemEngine::nativeAbsoluteFilePath(), QFSFileEnginePrivate::nativeHandle(), QFileSystemModelPrivate::node(), QOCIDriver::open(), openDocument(), openKey(), QTest::outputMessage(), QFileSystemEngine::owner(), QProcessPrivate::pipeWriterBytesToWrite(), populate_database(), QOCIResult::prepare(), qAxInit(), QDeclarative_isFileCaseCorrect(), qStreamNtlmString(), qStringAsUcs2Le(), qt_create_commandline(), qt_create_internal_window(), qt_create_pipe(), qt_message_output(), QAxServerBase::qt_metacall(), qt_reg_winclass(), qt_tablet_cleanup_wce(), qt_wce_insert_action(), qt_wce_rename_menu_item(), qt_win_get_existing_directory(), qt_win_get_save_file_name(), qt_win_make_OFN(), qt_wince_is_platform(), QtCeSetClipboard(), qToTChar(), QtWndProc(), QWin32PrintEnginePrivate::queryDefault(), qWinCmdArgs(), qWinMsgHandler(), MetaObjectGenerator::readClassInfo(), QWinSettingsPrivate::readKey(), readLink(), readSymLink(), QAxScriptManager::registerEngine(), registerFont(), QWindowsMime::registerMimeType(), QWinSettingsPrivate::remove(), QAxServerBase::Save(), QWinSettingsPrivate::set(), QAxBase::setControl(), QSystemTrayIconSys::setIconContents(), QSystemTrayIconSys::showMessage(), SoundPlayProc(), QConfFileSettingsPrivate::syncConfFile(), QSystemLocalePrivate::toCurrencyString(), toUcs4(), toWCharArray(), QFileSystemEngine::uncListSharesOnServer(), unregWinClasses(), UpdateRegistry(), winGetExistDirCallbackProc(), WinMain(), QEventDispatcherWin32Private::~QEventDispatcherWin32Private(), and QWinSettingsPrivate::~QWinSettingsPrivate().

ushort * data

Definition: qstring.h:606

◆ updateProperties()

void QString::updateProperties ( ) const

private

Warning: This function is not part of the public interface.

Definition at line 7510 of file qstring.cpp.

 {
     ushort *p = d->data;
     ushort *end = p + d->size;
     d->simpletext = true;
     while (p < end) {
         ushort uc = *p;
         // sort out regions of complex text formatting
         if (uc > 0x058f && (uc < 0x1100 || uc > 0xfb0f)) {
             d->simpletext = false;
         }
         p++;
     }
 
     d->righttoleft = isStringRightToLeft(d->data, d->data + d->size);
     d->clean = true;
 }

◆ utf16()

const ushort * QString::utf16 ( ) const

Returns the QString as a '\0\'-terminated array of unsigned shorts.

The result remains valid until the string is modified.

The returned string is in host byte order.

See also: unicode()

Definition at line 5290 of file qstring.cpp.

 {
     if (d->data != d->array) {
         QString *that = const_cast<QString*>(this);
         that->realloc();   // ensure '\\0'-termination for ::fromRawData strings
         return that->d->data;
     }
     return d->array;
 }

◆ vsprintf()

QString & QString::vsprintf	(	const char *	cformat,
		va_list	ap
	)

Equivalent method to sprintf(), but takes a va_list ap instead a list of variable arguments.

See the sprintf() documentation for an explanation of cformat.

This method does not call the va_end macro, the caller is responsible to call va_end on ap.

See also: sprintf()

Definition at line 5587 of file qstring.cpp.

Referenced by qErrnoWarning(), qt_message(), QByteArray::qvsnprintf(), and sprintf().

 {
     QLocale locale(QLocale::C);
 
     if (!cformat || !*cformat) {
         // Qt 1.x compat
         *this = fromLatin1("");
         return *this;
     }
 
     // Parse cformat
 
     QString result;
     const char *c = cformat;
     for (;;) {
         // Copy non-escape chars to result
 #ifndef QT_NO_TEXTCODEC
         int i = 0;
         while (*(c + i) != '\0' && *(c + i) != '%')
             ++i;
         if (codecForCStrings)
             result.append(codecForCStrings->toUnicode(c, i));
         else
             result.append(fromLatin1(c, i));
         c += i;
 #else
         while (*c != '\0' && *c != '%')
             result.append(QLatin1Char(*c++));
 #endif
 
         if (*c == '\0')
             break;
 
         // Found '%'
         const char *escape_start = c;
         ++c;
 
         if (*c == '\0') {
             result.append(QLatin1Char('%')); // a % at the end of the string - treat as non-escape text
             break;
         }
         if (*c == '%') {
             result.append(QLatin1Char('%')); // %%
             ++c;
             continue;
         }
 
         // Parse flag characters
         uint flags = 0;
         bool no_more_flags = false;
         do {
             switch (*c) {
                 case '#': flags |= QLocalePrivate::Alternate; break;
                 case '0': flags |= QLocalePrivate::ZeroPadded; break;
                 case '-': flags |= QLocalePrivate::LeftAdjusted; break;
                 case ' ': flags |= QLocalePrivate::BlankBeforePositive; break;
                 case '+': flags |= QLocalePrivate::AlwaysShowSign; break;
                 case '\'': flags |= QLocalePrivate::ThousandsGroup; break;
                 default: no_more_flags = true; break;
             }
 
             if (!no_more_flags)
                 ++c;
         } while (!no_more_flags);
 
         if (*c == '\0') {
             result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
             break;
         }
 
         // Parse field width
         int width = -1; // -1 means unspecified
         if (qIsDigit(*c)) {
             QString width_str;
             while (*c != '\0' && qIsDigit(*c))
                 width_str.append(QLatin1Char(*c++));
 
             // can't be negative - started with a digit
             // contains at least one digit
             width = width_str.toInt();
         }
         else if (*c == '*') {
             width = va_arg(ap, int);
             if (width < 0)
                 width = -1; // treat all negative numbers as unspecified
             ++c;
         }
 
         if (*c == '\0') {
             result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
             break;
         }
 
         // Parse precision
         int precision = -1; // -1 means unspecified
         if (*c == '.') {
             ++c;
             if (qIsDigit(*c)) {
                 QString precision_str;
                 while (*c != '\0' && qIsDigit(*c))
                     precision_str.append(QLatin1Char(*c++));
 
                 // can't be negative - started with a digit
                 // contains at least one digit
                 precision = precision_str.toInt();
             }
             else if (*c == '*') {
                 precision = va_arg(ap, int);
                 if (precision < 0)
                     precision = -1; // treat all negative numbers as unspecified
                 ++c;
             }
         }
 
         if (*c == '\0') {
             result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
             break;
         }
 
         // Parse the length modifier
         enum LengthMod { lm_none, lm_hh, lm_h, lm_l, lm_ll, lm_L, lm_j, lm_z, lm_t };
         LengthMod length_mod = lm_none;
         switch (*c) {
             case 'h':
                 ++c;
                 if (*c == 'h') {
                     length_mod = lm_hh;
                     ++c;
                 }
                 else
                     length_mod = lm_h;
                 break;
 
             case 'l':
                 ++c;
                 if (*c == 'l') {
                     length_mod = lm_ll;
                     ++c;
                 }
                 else
                     length_mod = lm_l;
                 break;
 
             case 'L':
                 ++c;
                 length_mod = lm_L;
                 break;
 
             case 'j':
                 ++c;
                 length_mod = lm_j;
                 break;
 
             case 'z':
             case 'Z':
                 ++c;
                 length_mod = lm_z;
                 break;
 
             case 't':
                 ++c;
                 length_mod = lm_t;
                 break;
 
             default: break;
         }
 
         if (*c == '\0') {
             result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
             break;
         }
 
         // Parse the conversion specifier and do the conversion
         QString subst;
         switch (*c) {
             case 'd':
             case 'i': {
                 qint64 i;
                 switch (length_mod) {
                     case lm_none: i = va_arg(ap, int); break;
                     case lm_hh: i = va_arg(ap, int); break;
                     case lm_h: i = va_arg(ap, int); break;
                     case lm_l: i = va_arg(ap, long int); break;
                     case lm_ll: i = va_arg(ap, qint64); break;
                     case lm_j: i = va_arg(ap, long int); break;
                     case lm_z: i = va_arg(ap, size_t); break;
                     case lm_t: i = va_arg(ap, int); break;
                     default: i = 0; break;
                 }
                 subst = locale.d()->longLongToString(i, precision, 10, width, flags);
                 ++c;
                 break;
             }
             case 'o':
             case 'u':
             case 'x':
             case 'X': {
                 quint64 u;
                 switch (length_mod) {
                     case lm_none: u = va_arg(ap, uint); break;
                     case lm_hh: u = va_arg(ap, uint); break;
                     case lm_h: u = va_arg(ap, uint); break;
                     case lm_l: u = va_arg(ap, ulong); break;
                     case lm_ll: u = va_arg(ap, quint64); break;
                     case lm_z: u = va_arg(ap, size_t); break;
                     default: u = 0; break;
                 }
 
                 if (qIsUpper(*c))
                     flags |= QLocalePrivate::CapitalEorX;
 
                 int base = 10;
                 switch (qToLower(*c)) {
                     case 'o':
                         base = 8; break;
                     case 'u':
                         base = 10; break;
                     case 'x':
                         base = 16; break;
                     default: break;
                 }
                 subst = locale.d()->unsLongLongToString(u, precision, base, width, flags);
                 ++c;
                 break;
             }
             case 'E':
             case 'e':
             case 'F':
             case 'f':
             case 'G':
             case 'g':
             case 'A':
             case 'a': {
                 double d;
                 if (length_mod == lm_L)
                     d = va_arg(ap, long double); // not supported - converted to a double
                 else
                     d = va_arg(ap, double);
 
                 if (qIsUpper(*c))
                     flags |= QLocalePrivate::CapitalEorX;
 
                 QLocalePrivate::DoubleForm form = QLocalePrivate::DFDecimal;
                 switch (qToLower(*c)) {
                     case 'e': form = QLocalePrivate::DFExponent; break;
                     case 'a':                             // not supported - decimal form used instead
                     case 'f': form = QLocalePrivate::DFDecimal; break;
                     case 'g': form = QLocalePrivate::DFSignificantDigits; break;
                     default: break;
                 }
                 subst = locale.d()->doubleToString(d, precision, form, width, flags);
                 ++c;
                 break;
             }
             case 'c': {
                 if (length_mod == lm_l)
                     subst = QChar((ushort) va_arg(ap, int));
                 else
                     subst = QLatin1Char((uchar) va_arg(ap, int));
                 ++c;
                 break;
             }
             case 's': {
                 if (length_mod == lm_l) {
                     const ushort *buff = va_arg(ap, const ushort*);
                     const ushort *ch = buff;
                     while (*ch != 0)
                         ++ch;
                     subst.setUtf16(buff, ch - buff);
                 } else
                     subst = QString::fromUtf8(va_arg(ap, const char*));
                 if (precision != -1)
                     subst.truncate(precision);
                 ++c;
                 break;
             }
             case 'p': {
                 void *arg = va_arg(ap, void*);
 #ifdef Q_OS_WIN64
                 quint64 i = reinterpret_cast<quint64>(arg);
 #else
                 quint64 i = reinterpret_cast<unsigned long>(arg);
 #endif
                 flags |= QLocalePrivate::Alternate;
                 subst = locale.d()->unsLongLongToString(i, precision, 16, width, flags);
                 ++c;
                 break;
             }
             case 'n':
                 switch (length_mod) {
                     case lm_hh: {
                         signed char *n = va_arg(ap, signed char*);
                         *n = result.length();
                         break;
                     }
                     case lm_h: {
                         short int *n = va_arg(ap, short int*);
                         *n = result.length();
                             break;
                     }
                     case lm_l: {
                         long int *n = va_arg(ap, long int*);
                         *n = result.length();
                         break;
                     }
                     case lm_ll: {
                         qint64 *n = va_arg(ap, qint64*);
                         volatile uint tmp = result.length(); // egcs-2.91.66 gets internal
                         *n = tmp;                             // compiler error without volatile
                         break;
                     }
                     default: {
                         int *n = va_arg(ap, int*);
                         *n = result.length();
                         break;
                     }
                 }
                 ++c;
                 break;
 
             default: // bad escape, treat as non-escape text
                 for (const char *cc = escape_start; cc != c; ++cc)
                     result.append(QLatin1Char(*cc));
                 continue;
         }
 
         if (flags & QLocalePrivate::LeftAdjusted)
             result.append(subst.leftJustified(width));
         else
             result.append(subst.rightJustified(width));
     }
 
     *this = result;
 
     return *this;
 }

Friends and Related Functions

◆ operator!=()

bool operator!=	(	const char *	s1,
		const QString &	s2
	)

For s1 != 0, this is equivalent to {compare(} s1, s2 {) != 0}. Note that no string is equal to s1 being 0.

See also: QString::compare()

Definition at line 938 of file qstring.h.

939 { return !qStringComparisonHelper(s2, s1); }

friend bool qStringComparisonHelper(const QString &s1, const char *s2)

Definition: qstring.h:916

◆ operator+() [1/5]

const QString operator+	(	const QString &	s1,
		const QString &	s2
	)

Definition at line 1021 of file qstring.h.

1022 { QString t(s1); t += s2; return t; }

The QString class provides a Unicode character string.

Definition: qstring.h:83

◆ operator+() [2/5]

const QString operator+	(	const QString &	s1,
		const char *	s2
	)

See also: QString::fromAscii()

Definition at line 1028 of file qstring.h.

1029 { QString t(s1); t += QString::fromAscii(s2); return t; }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

The QString class provides a Unicode character string.

Definition: qstring.h:83

◆ operator+() [3/5]

const QString operator+	(	const char *	s1,
		const QString &	s2
	)

See also: QString::fromAscii()

Definition at line 1030 of file qstring.h.

1031 { QString t = QString::fromAscii(s1); t += s2; return t; }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

The QString class provides a Unicode character string.

Definition: qstring.h:83

◆ operator+() [4/5]

const QString operator+	(	const QString &	s,
		char	ch
	)

Definition at line 1034 of file qstring.h.

1035 { QString t = s; t += QChar::fromAscii(c); return t; }

unsigned char c[8]

Definition: qnumeric_p.h:62

The QString class provides a Unicode character string.

Definition: qstring.h:83

static QChar fromAscii(char c)

Converts the ASCII character c to its equivalent QChar.

Definition: qchar.cpp:1521

◆ operator+() [5/5]

const QString operator+	(	char	ch,
		const QString &	s
	)

Definition at line 1032 of file qstring.h.

1033 { QString t = s; t.prepend(QChar::fromAscii(c)); return t; }

unsigned char c[8]

Definition: qnumeric_p.h:62

QString & prepend(QChar c)

Definition: qstring.h:261

The QString class provides a Unicode character string.

Definition: qstring.h:83

static QChar fromAscii(char c)

Converts the ASCII character c to its equivalent QChar.

Definition: qchar.cpp:1521

◆ operator<()

bool operator<	(	const char *	s1,
		const QString &	s2
	)

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings using the QString::localeAwareCompare() function.

See also: QString::compare()

Definition at line 940 of file qstring.h.

941 { return (QString::fromAscii(s1) < s2); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator<<()

QDataStream & operator<<	(	QDataStream &	stream,
		const QString &	string
	)

See also: {Serializing Qt Data Types}

Definition at line 8034 of file qstring.cpp.

Referenced by fromStdWString().

 {
     if (out.version() == 1) {
         out << str.toLatin1();
     } else {
         if (!str.isNull() || out.version() < 3) {
             if ((out.byteOrder() == QDataStream::BigEndian) == (QSysInfo::ByteOrder == QSysInfo::BigEndian)) {
                 out.writeBytes(reinterpret_cast<const char *>(str.unicode()), sizeof(QChar) * str.length());
             } else {
                 QVarLengthArray<ushort> buffer(str.length());
                 const ushort *data = reinterpret_cast<const ushort *>(str.constData());
                 for (int i = 0; i < str.length(); i++) {
                     buffer[i] = qbswap(*data);
                     ++data;
                 }
                 out.writeBytes(reinterpret_cast<const char *>(buffer.data()), sizeof(ushort) * buffer.size());
             }
         } else {
             // write null marker
             out << (quint32)0xffffffff;
         }
     }
     return out;
 }

◆ operator<=()

bool operator<=	(	const char *	s1,
		const QString &	s2
	)

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings with QString::localeAwareCompare().

See also: QString::compare()

Definition at line 944 of file qstring.h.

945 { return (QString::fromAscii(s1) <= s2); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator==operator==()

bool operator==operator==	(	const char *	s1,
		const QString &	s2,
		const char *	s1,
		const QString &	s2
	)

Equivalent to {s1 != 0 && compare(s1, s2) == 0}.

See also: QString::compare()

◆ operator>()

bool operator>	(	const char *	s1,
		const QString &	s2
	)

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings using the QString::localeAwareCompare() function.

See also: QString::compare()

Definition at line 942 of file qstring.h.

943 { return (QString::fromAscii(s1) > s2); }

static QString fromAscii(const char *, int size=-1)

Returns a QString initialized with the first size characters from the string str. ...

Definition: qstring.cpp:4276

◆ operator>=()

bool operator>=	(	const char *	s1,
		const QString &	s2
	)

The comparison is based exclusively on the numeric Unicode values of the characters and is very fast, but is not what a human would expect. Consider sorting user-interface strings using the QString::localeAwareCompare() function.

Definition at line 946 of file qstring.h.

947 { return (QString::fromAscii(s1) >= s2); }