- Qt 5.15
- Qt Core
- C++ Classes
- QString
- Qt 5.15.19 Reference Documentation

# Obsolete Members for QString

The following members of class QString are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

## Public Types

`(obsolete)` enum | SplitBehavior { KeepEmptyParts, SkipEmptyParts }

## Public Functions

`(obsolete)` QStringList | split(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
`(obsolete)` QStringList | split(QChar sep, SplitBehavior behavior, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
`(obsolete)` QStringList | split(const QRegExp &rx, SplitBehavior behavior) const
`(obsolete)` QStringList | split(const QRegularExpression &re, SplitBehavior behavior) const
`(obsolete)` QVector<QStringRef> | splitRef(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
`(obsolete)` QVector<QStringRef> | splitRef(const QRegExp &rx, SplitBehavior behavior) const
`(obsolete)` QVector<QStringRef> | splitRef(const QRegularExpression &re, SplitBehavior behavior) const
`(obsolete)` QString & | sprintf(const char *cformat, ...)
`(obsolete)` QByteArray | toAscii() const
`(obsolete)` QString & | vsprintf(const char *cformat, va_list ap)

## Static Public Members

`(obsolete)` QString | fromAscii(const char *str, int size = -1)
`(obsolete)` QString | fromAscii(const QByteArray &str)

## Member Type Documentation

### enum QString::SplitBehavior

This enum is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use Qt::SplitBehavior instead.

This enum specifies how the split() function should behave with respect to empty strings.

Constant | Value | Description
--- | --- | ---
`QString::KeepEmptyParts` | `0` | If a field is empty, keep it in the result.
`QString::SkipEmptyParts` | `1` | If a field is empty, don't include it in the result.

See also split().

## Member Function Documentation

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

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

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

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

This function does the same as fromLatin1().

See also toAscii(), fromLatin1(), fromUtf8(), and fromLocal8Bit().

### `[static]` QString QString::fromAscii(const QByteArray &str)

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Returns a QString initialized with the string str.

This function was introduced in Qt 5.0.

### QStringList QString::split(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::split(const QString &sep, Qt::SplitBehavior behavior, Qt::CaseSensitivity cs) instead.

### QStringList QString::split(QChar sep, SplitBehavior behavior, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::split(QChar sep, Qt::SplitBehavior behavior, Qt::CaseSensitivity cs) instead.

### QStringList QString::split(const QRegExp &rx, SplitBehavior behavior) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::split(const QRegularExpression &sep, Qt::SplitBehavior behavior) instead.

### QStringList QString::split(const QRegularExpression &re, SplitBehavior behavior) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::split(const QRegularExpression &sep, Qt::SplitBehavior behavior) instead.

This function was introduced in Qt 5.0.

### QVector<QStringRef> QString::splitRef(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::splitRef(const QString &sep, Qt::SplitBehavior behavior, Qt::CaseSensitivity cs) instead.

This function was introduced in Qt 5.4.

### QVector<QStringRef> QString::splitRef(const QRegExp &rx, SplitBehavior behavior) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::splitRef(const QRegularExpression &sep, Qt::SplitBehavior behavior) instead.

This function was introduced in Qt 5.4.

### QVector<QStringRef> QString::splitRef(const QRegularExpression &re, SplitBehavior behavior) const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

This is an overloaded function.

Use QString::splitRef(const QRegularExpression &sep, Qt::SplitBehavior behavior) instead.

This function was introduced in Qt 5.4.

### QString &QString::sprintf(const char *cformat, ...)

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use asprintf(), arg() or QTextStream instead.

### QByteArray QString::toAscii() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Returns an 8-bit representation of the string as a QByteArray.

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(), and QTextCodec.

### QString &QString::vsprintf(const char *cformat, va_list ap)

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use vasprintf(), arg() or QTextStream instead.