MythTV  master
mythsorthelper.cpp
Go to the documentation of this file.
1 // -*- Mode: c++ -*-
2 // vim: set expandtab tabstop=4 shiftwidth=4
3 
4 #include "mythsorthelper.h"
5 
6 #include "mythcorecontext.h"
7 
15 {
16  m_prefixes = tr("^(The |A |An )",
17  "Regular Expression for what to ignore when sorting");
18  m_prefixes = m_prefixes.trimmed();
19  if (not hasPrefixes()) {
20  // This language doesn't ignore any words when sorting
22  return;
23  }
24  if (not m_prefixes.startsWith("^"))
25  m_prefixes = "^" + m_prefixes;
26 
27  if (m_caseSensitive == Qt::CaseInsensitive)
28  {
29  m_prefixes = m_prefixes.toLower();
30  m_exclusions = m_exclusions.toLower();
31  }
32  m_prefixesRegex = QRegularExpression(m_prefixes);
33  m_prefixesRegex2 = QRegularExpression(m_prefixes + "(.*)");
34  m_exclList = m_exclusions.split(";", Qt::SkipEmptyParts);
35  // NOLINTNEXTLINE(modernize-loop-convert)
36  for (int i = 0; i < m_exclList.size(); i++)
37  m_exclList[i] = m_exclList[i].trimmed();
38 }
39 
50 {
51  if (gCoreContext) {
52 #if 0
53  // Last minute change. QStringRef::localeAwareCompare appears to
54  // always do case insensitive sorting, so there's no point in
55  // presenting this option to a user.
57  gCoreContext->GetBoolSetting("SortCaseSensitive", false)
58  ? Qt::CaseSensitive : Qt::CaseInsensitive;
59 #endif
60  m_prefixMode =
61  gCoreContext->GetBoolSetting("SortStripPrefixes", true)
63  m_exclusions =
64  gCoreContext->GetSetting("SortPrefixExceptions", "");
65  }
67 }
68 
82  Qt::CaseSensitivity case_sensitive,
83  SortPrefixMode prefix_mode,
84  QString exclusions) :
85  m_caseSensitive(case_sensitive),
86  m_prefixMode(prefix_mode),
87  m_exclusions(std::move(exclusions))
88 {
90 }
91 
102 {
103  if (other == nullptr)
104  {
105  LOG(VB_GENERAL, LOG_ERR,
106  QString("MythSortHelper created from null pointer."));
107  return;
108  }
110  m_prefixMode = other->m_prefixMode;
111  m_prefixes = other->m_prefixes;
114  m_exclusions = other->m_exclusions;
115  m_exclList = other->m_exclList;
116  m_exclMode = other->m_exclMode;
117 }
118 
119 static std::shared_ptr<MythSortHelper> singleton = nullptr;
120 
129 std::shared_ptr<MythSortHelper> getMythSortHelper(void)
130 {
131  if (singleton == nullptr)
132  // coverity[resource_leak]
133  singleton = std::make_shared<MythSortHelper>(new MythSortHelper());
134  return singleton;
135 }
136 
147 {
148  singleton = nullptr;
149 }
150 
163 QString MythSortHelper::doTitle(const QString& title) const
164 {
165  QString ltitle = title;
166  if (m_caseSensitive == Qt::CaseInsensitive)
167  ltitle = ltitle.toLower();
169  return ltitle;
171  {
172  if (m_exclList.contains(ltitle))
173  return ltitle;
174  } else {
175  for (const auto& str : std::as_const(m_exclList))
176  if (ltitle.startsWith(str))
177  return ltitle;
178  }
180  return ltitle.remove(m_prefixesRegex);
181  return ltitle.replace(m_prefixesRegex2, "\\2, \\1").trimmed();
182 }
183 
196 QString MythSortHelper::doPathname(const QString& pathname) const
197 {
198  QString lpathname = pathname;
199  if (m_caseSensitive == Qt::CaseInsensitive)
200  lpathname = lpathname.toLower();
202  return lpathname;
203  QStringList parts = lpathname.split("/");
204  // NOLINTNEXTLINE(modernize-loop-convert)
205  for (int i = 0; i < parts.size(); ++i) {
206  if (std::any_of(m_exclList.cbegin(), m_exclList.cend(),
207  [&parts,i](const QString& excl)
208  { return parts[i].startsWith(excl); } ))
209  continue;
211  parts[i] = parts[i].remove(m_prefixesRegex);
212  else
213  parts[i] = parts[i].replace(m_prefixesRegex2, "\\2, \\1").trimmed();
214  }
215  return parts.join("/");
216 }
MythSortHelper::m_exclMode
SortExclusionMode m_exclMode
Definition: mythsorthelper.h:78
MythSortHelper::m_prefixes
QString m_prefixes
A string containing the regular expression of prefixes to ignore when sorting.
Definition: mythsorthelper.h:62
getMythSortHelper
std::shared_ptr< MythSortHelper > getMythSortHelper(void)
Get a pointer to the MythSortHelper singleton.
Definition: mythsorthelper.cpp:129
SortExclusionMatch
@ SortExclusionMatch
Definition: mythsorthelper.h:21
LOG
#define LOG(_MASK_, _LEVEL_, _QSTRING_)
Definition: mythlogging.h:39
MythSortHelper
A class to consolidate all the soring functions.
Definition: mythsorthelper.h:28
MythSortHelper::m_caseSensitive
Qt::CaseSensitivity m_caseSensitive
Whether sorting two strings should ignore upper/lower case.
Definition: mythsorthelper.h:53
MythSortHelper::m_exclusions
QString m_exclusions
A string containing names that should be ignored when greating the sortable form of a title.
Definition: mythsorthelper.h:75
mythsorthelper.h
MythSortHelper::doPathname
QString doPathname(const QString &pathname) const
Create the sortable form of an item.
Definition: mythsorthelper.cpp:196
SortPrefixRemove
@ SortPrefixRemove
Definition: mythsorthelper.h:15
MythSortHelper::doTitle
QString doTitle(const QString &title) const
Create the sortable form of an title string.
Definition: mythsorthelper.cpp:163
MythSortHelper::MythSortHelperCommon
void MythSortHelperCommon(void)
Common code for creating a MythSortHelper object.
Definition: mythsorthelper.cpp:14
MythSortHelper::m_exclList
QStringList m_exclList
The m_exclusion string converted into a string list.
Definition: mythsorthelper.h:77
MythSortHelper::MythSortHelper
MythSortHelper()
Create a MythSortHelper object.
Definition: mythsorthelper.cpp:49
MythSortHelper::m_prefixMode
SortPrefixMode m_prefixMode
Whether or not to ignore prefix words (like A, An, and The) when sorting two strings.
Definition: mythsorthelper.h:57
MythSortHelper::m_prefixesRegex2
QRegularExpression m_prefixesRegex2
A regular expression used for moving leading prefix to the end of a string.
Definition: mythsorthelper.h:68
gCoreContext
MythCoreContext * gCoreContext
This global variable contains the MythCoreContext instance for the app.
Definition: mythcorecontext.cpp:55
MythSortHelper::hasPrefixes
bool hasPrefixes(void)
Does the language translation specify any prefixes.
Definition: mythsorthelper.h:47
MythCoreContext::GetBoolSetting
bool GetBoolSetting(const QString &key, bool defaultval=false)
Definition: mythcorecontext.cpp:906
mythcorecontext.h
MythSortHelper::m_prefixesRegex
QRegularExpression m_prefixesRegex
A regular expression used for removing a leading prefix.
Definition: mythsorthelper.h:65
SortPrefixMode
SortPrefixMode
Definition: mythsorthelper.h:12
std
Definition: mythchrono.h:23
resetMythSortHelper
void resetMythSortHelper(void)
Delete the MythSortHelper singleton.
Definition: mythsorthelper.cpp:146
SortPrefixKeep
@ SortPrefixKeep
Definition: mythsorthelper.h:14
singleton
static std::shared_ptr< MythSortHelper > singleton
Definition: mythsorthelper.cpp:119
MythCoreContext::GetSetting
QString GetSetting(const QString &key, const QString &defaultval="")
Definition: mythcorecontext.cpp:898