Logo Search packages:      
Sourcecode: tellico version File versions

QString Field::formatName ( const QString &  name,
bool  multiple = true 
) [static]

A convenience function to format a string as a personal name. At the moment, this means that the name is split at the last white space, and the last name is moved in front. If multiple=true, then the string is split using a semi-colon (";"), and each string is formatted and then joined back together. If autoCapitalize() is true, the names are capitalized.

name The string to be formatted
multiple A boolean indicating if the string can contain multiple values

Definition at line 213 of file field.cpp.

References autoCapitalize(), autoFormat(), capitalize(), and name().

Referenced by format().

  static const QRegExp spaceComma(QString::fromLatin1("[\\s,]"));

  QStringList entries;
  if(multiple_) {
    // split by semi-colon, optionally preceded or followed by white spacee
    entries = QStringList::split(s_delimiter, name_, false);
  } else {
    entries << name_;

  QRegExp lastWord;
  const QString colonColon = QString::fromLatin1("::");
  // the ending look-ahead is so that a space is not added at the end
  const QRegExp periodSpace(QString::fromLatin1("\\.\\s*(?=.)"));

  QStringList names;
  for(QStringList::ConstIterator it = entries.begin(); it != entries.end(); ++it) {
    QString name = *it;
    // special case for 2-column tables, assume user never has '::' in a value
    QString tail;
    if(name.find(colonColon) > -1) {
      tail = colonColon + name.section(colonColon, 1);
      name = name.section(colonColon, 0, 0);
    name.replace(periodSpace, QString::fromLatin1(". "));
    if(autoCapitalize()) {
      name = capitalize(name);

    // split the name by white space and commas
    QStringList words = QStringList::split(spaceComma, name, false);
    lastWord.setPattern(QChar('^') + QRegExp::escape(words.last()) + QChar('$'));

    // if it contains a comma already and the last word is not a suffix, don't format it
    if(!autoFormat() || name.find(',') > -1 && s_suffixes.grep(lastWord).isEmpty()) {
      // arbitrarily impose rule that no spaces before a comma and
      // a single space after every comma
      name.replace(comma_split, QString::fromLatin1(", "));
      names << name + tail;
    // otherwise split it by white space, move the last word to the front
    // but only if there is more than one word
    if(words.count() > 1) {
      // if the last word is a suffix, it has to be kept with last name
      if(s_suffixes.grep(lastWord).count() > 0) {

      // now move the word
      // adding comma here when there had been a suffix is because it was originally split with space or comma

      // update last word regexp
      lastWord.setPattern(QChar('^') + QRegExp::escape(words.last()) + QChar('$'));

      // this is probably just something for me, limited to english
      while(s_surnamePrefixes.grep(lastWord).count() > 0) {
        lastWord.setPattern(QChar('^') + QRegExp::escape(words.last()) + QChar('$'));

      names << words.join(QChar(' ')) + tail;
    } else {
      names << name + tail;

  return names.join(QString::fromLatin1("; "));

Generated by  Doxygen 1.6.0   Back to index