string.hxx

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 */
#pragma once
 
#include <sal/config.h>
 
#include <algorithm>
#include <vector>
#include <comphelper/comphelperdllapi.h>
#include <sal/types.h>
#include <rtl/strbuf.hxx>
#include <rtl/ustrbuf.hxx>
#include <com/sun/star/uno/Sequence.h>
#include <com/sun/star/uno/Reference.hxx>
 
#include <com/sun/star/lang/Locale.hpp>
 
namespace com::sun::star::i18n { class XBreakIterator; }
namespace com::sun::star::i18n { class XCollator; }
namespace com::sun::star::uno { class XComponentContext; }
 
// OUString helper functions that are not widespread or mature enough to
// go into the stable URE API:
namespace comphelper::string {
 
inline OUStringBuffer& remove(OUStringBuffer &rIn,
    sal_Unicode c)
{
    sal_Int32 index = 0;
    while (true)
    {
        if (index >= rIn.getLength())
            break;
        index = rIn.indexOf(c, index);
        if (index == -1)
            break;
        rIn.remove(index, 1);
    }
    return rIn;
}
 
COMPHELPER_DLLPUBLIC OString stripStart(const OString& rIn,
    char c);
COMPHELPER_DLLPUBLIC std::string_view stripStart(std::string_view rIn,
    char c);
 
COMPHELPER_DLLPUBLIC OUString stripStart(const OUString& rIn,
    sal_Unicode c);
COMPHELPER_DLLPUBLIC std::u16string_view stripStart(std::u16string_view rIn,
    sal_Unicode c);
 
COMPHELPER_DLLPUBLIC OString stripEnd(const OString& rIn,
    char c);
COMPHELPER_DLLPUBLIC std::string_view stripEnd(std::string_view rIn,
    char c);
 
COMPHELPER_DLLPUBLIC OUString stripEnd(const OUString& rIn,
    sal_Unicode c);
COMPHELPER_DLLPUBLIC std::u16string_view stripEnd(std::u16string_view rIn,
    sal_Unicode c);
 
COMPHELPER_DLLPUBLIC OString strip(const OString& rIn,
    char c);
COMPHELPER_DLLPUBLIC std::string_view strip(std::string_view rIn,
    char c);
 
COMPHELPER_DLLPUBLIC OUString strip(const OUString& rIn,
    sal_Unicode c);
COMPHELPER_DLLPUBLIC std::u16string_view strip(std::u16string_view rIn,
    sal_Unicode c);
 
COMPHELPER_DLLPUBLIC sal_Int32 getTokenCount(std::string_view rIn, char cTok);
 
COMPHELPER_DLLPUBLIC sal_Int32 getTokenCount(std::u16string_view rIn, sal_Unicode cTok);
 
COMPHELPER_DLLPUBLIC OUString reverseString(std::u16string_view rStr);
 
COMPHELPER_DLLPUBLIC OUString reverseCodePoints(OUString const & str);
 
 
namespace detail
{
    template<typename B> B& truncateToLength(B& rBuffer, sal_Int32 nLen)
    {
        if (nLen < rBuffer.getLength())
            rBuffer.setLength(nLen);
        return rBuffer;
    }
}
 
inline OUStringBuffer& truncateToLength(
    OUStringBuffer& rBuffer, sal_Int32 nLength)
{
    return detail::truncateToLength(rBuffer, nLength);
}
 
namespace detail
{
    template<typename B, typename U> B& padToLength(B& rBuffer, sal_Int32 nLen, U cFill)
    {
        const sal_Int32 nPadLen = nLen - rBuffer.getLength();
        if (nPadLen > 0)
            std::fill_n(rBuffer.appendUninitialized(nPadLen), nPadLen, cFill);
        return rBuffer;
    }
}
 
inline OStringBuffer& padToLength(
    OStringBuffer& rBuffer, sal_Int32 nLength,
    char cFill = '\0')
{
    return detail::padToLength(rBuffer, nLength, cFill);
}
 
inline OUStringBuffer& padToLength(
    OUStringBuffer& rBuffer, sal_Int32 nLength,
    sal_Unicode cFill = '\0')
{
    return detail::padToLength(rBuffer, nLength, cFill);
}
 
COMPHELPER_DLLPUBLIC void replaceAt(OUStringBuffer& rIn, sal_Int32 index, sal_Int32 count, std::u16string_view newStr );
 
COMPHELPER_DLLPUBLIC OUString setToken(const OUString& rIn, sal_Int32 nToken, sal_Unicode cTok,
    std::u16string_view rNewToken);
 
COMPHELPER_DLLPUBLIC sal_Int32 indexOfAny(std::u16string_view rIn,
        sal_Unicode const*const pChars, sal_Int32 const nPos);
 
COMPHELPER_DLLPUBLIC OUString removeAny(std::u16string_view rIn,
        sal_Unicode const*const pChars);
 
COMPHELPER_DLLPUBLIC OUString convertCommaSeparated(
    css::uno::Sequence< OUString > const & i_rSeq);
 
COMPHELPER_DLLPUBLIC OString join(std::string_view rSeparator, const std::vector<OString>& rSequence);
 
COMPHELPER_DLLPUBLIC sal_uInt32 decimalStringToNumber(
    std::u16string_view str );
 
COMPHELPER_DLLPUBLIC std::vector<OUString>
    split(std::u16string_view rString, const sal_Unicode cSeparator);
 
COMPHELPER_DLLPUBLIC css::uno::Sequence< OUString >
    convertCommaSeparated( std::u16string_view i_rString );
 
COMPHELPER_DLLPUBLIC sal_Int32 compareNatural( const OUString &rLHS, const OUString &rRHS,
    const css::uno::Reference< css::i18n::XCollator > &rCollator,
    const css::uno::Reference< css::i18n::XBreakIterator > &rBI,
    const css::lang::Locale &rLocale );
 
class COMPHELPER_DLLPUBLIC NaturalStringSorter
{
private:
    css::lang::Locale const                          m_aLocale;
    css::uno::Reference< css::i18n::XCollator >      m_xCollator;
    css::uno::Reference< css::i18n::XBreakIterator > m_xBI;
public:
    NaturalStringSorter(
        const css::uno::Reference< css::uno::XComponentContext > &rContext,
        css::lang::Locale aLocale);
    sal_Int32 compare(const OUString &rLHS, const OUString &rRHS) const
    {
        return compareNatural(rLHS, rRHS, m_xCollator, m_xBI, m_aLocale);
    }
    const css::lang::Locale& getLocale() const { return m_aLocale; }
};
 
COMPHELPER_DLLPUBLIC bool isdigitAsciiString(std::string_view rString);
 
COMPHELPER_DLLPUBLIC bool isdigitAsciiString(std::u16string_view rString);
 
COMPHELPER_DLLPUBLIC OUString sanitizeStringSurrogates(const OUString& rString);
 
} // namespace comphelper::string
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */