e25fd7782a
Change-Id: I9ab8876aac7b2f8b488db6dfa9c6fd0cecd2238b Reviewed-on: https://gerrit.libreoffice.org/c/core/+/104626 Tested-by: Jenkins Reviewed-by: Noel Grandin <noel.grandin@collabora.co.uk>
167 lines
4.7 KiB
C++
167 lines
4.7 KiB
C++
/* -*- 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 .
|
|
*/
|
|
|
|
#ifndef INCLUDED_HWPFILTER_SOURCE_MZSTRING_H
|
|
#define INCLUDED_HWPFILTER_SOURCE_MZSTRING_H
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
# include "config.h"
|
|
#endif
|
|
#include <tools/long.hxx>
|
|
|
|
/** @name MzString class
|
|
|
|
It was supposed to be used instead of std::string.
|
|
|
|
Notes for usage:
|
|
|
|
When you declare an MzString, it is initially empty. There is no need to
|
|
do things like #MzString a = "";#, especially not in constructors.
|
|
|
|
If you want to use a default empty MzString as a parameter, use
|
|
|
|
#void foo(MzString par = MzString()); // Correct#
|
|
|
|
rather than
|
|
|
|
#void foo(MzString par = ""); // WRONG!#
|
|
#void foo(MzString par = 0); // WRONG!#
|
|
|
|
(The last one is only wrong because some compilers can't handle it.)
|
|
|
|
Methods that take an index as parameter all follow this rule: Valid indexes
|
|
go from 0 to length()-1.
|
|
\begin{tabular}{rl}
|
|
Correct: & #foo.substr(0, length()-1);# \\
|
|
Wrong: & #bar.substr(0, length());#
|
|
\end{tabular}
|
|
|
|
It is important that you declare MzStrings as const if possible, because
|
|
some methods are much more efficient in const versions.
|
|
|
|
If you want to check whether a string is empty, do
|
|
|
|
#if (foo.empty()) something right#
|
|
|
|
rather than something along the lines of
|
|
|
|
#if (!foo) completely wrong#
|
|
|
|
When you use the #.copy()# method, MzString calls "#new []#", so you have to
|
|
release the memory with #delete[]#. Don't preallocate memory.
|
|
|
|
When you want to copy an MzString, just do
|
|
|
|
#MzString a, b = "String";#
|
|
#a = b; // That's it!#
|
|
|
|
not something like
|
|
|
|
#MzString a, b = "String";#
|
|
#a = b.copy();#
|
|
|
|
The class automatically handles deep copying when required.
|
|
*/
|
|
|
|
class MzString
|
|
{
|
|
public:
|
|
MzString(); // Create an empty string
|
|
~MzString();
|
|
|
|
int length() const;
|
|
const char* c_str() const;
|
|
operator char*() { return const_cast<char *>(c_str()); }
|
|
|
|
// Assignment
|
|
MzString &operator = (const MzString &s);
|
|
MzString &operator = (const char *s);
|
|
|
|
// Appending
|
|
|
|
MzString &operator << (const char *);
|
|
MzString &operator << (char);
|
|
MzString &operator << (unsigned char c) { return *this<<static_cast<char>(c); }
|
|
MzString &operator << (int);
|
|
MzString &operator << (tools::Long);
|
|
MzString &operator << (short i) { return *this<<static_cast<int>(i); }
|
|
MzString &operator << (MzString const &);
|
|
/* MzString &operator << (MzString *s) { return *this<<*s; }
|
|
|
|
// Removing
|
|
char operator >> (char &c);
|
|
*/
|
|
// Access to specific characters
|
|
//char &operator [] (int n);
|
|
char operator [] (int n);
|
|
|
|
// Comparison
|
|
// Return:
|
|
// 0 : 'this' is equal to 's'.
|
|
// -1 : 'this' is less than 's'.
|
|
// 1 : 'this' is greater than 's'.
|
|
int compare(const char *s);
|
|
|
|
// Searching for parts
|
|
int find (char c);
|
|
int find (char c, int pos);
|
|
int rfind (char c);
|
|
int rfind (char c, int pos);
|
|
|
|
// Manipulation
|
|
void replace(int, char c);
|
|
|
|
void append (MzString const &s);
|
|
void append (const char *s);
|
|
void append (const char *s, int n);
|
|
|
|
private:
|
|
int Length; // Current Length
|
|
int Allocated; // Total space allocated
|
|
char *Data; // The actual contents
|
|
|
|
// Allocate some space for the data.
|
|
// Delete Data if it has been allocated.
|
|
bool allocate(int len);
|
|
};
|
|
|
|
inline int MzString::length() const
|
|
{
|
|
return Length;
|
|
}
|
|
|
|
|
|
inline const char* MzString::c_str() const
|
|
{
|
|
if (Data)
|
|
{
|
|
Data[Length] = '\0'; // We always leave room for this.
|
|
return Data;
|
|
}
|
|
else
|
|
return "";
|
|
}
|
|
|
|
|
|
|
|
// Non friend, non member operators
|
|
|
|
#endif // INCLUDED_HWPFILTER_SOURCE_MZSTRING_H
|
|
|
|
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|