]> git.lyx.org Git - lyx.git/blobdiff - src/vspace.C
add comment
[lyx.git] / src / vspace.C
index 6c1e46f34a6731f3971e0d2e7b91fb3fd50d416b..c1fdbf71ad93d5747f5dc0a219b58b96658fdd18 100644 (file)
@@ -1,43 +1,54 @@
-/* This file is part of
- * ======================================================
+/**
+ * \file vspace.C
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- *           LyX, The Document Processor
- *     
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2001 The LyX Team.
+ * \author Matthias Ettrich
  *
- * ====================================================== */
+ * Full author contact details are available in file CREDITS.
+ */
 
 #include <config.h>
 
-#ifdef __GNUG__
-#pragma implementation
-#endif
-
 #include "vspace.h"
-#include "lengthcommon.h"
-#include "lyx_main.h"
 #include "buffer.h"
-#include "lyxrc.h"
-#include "lyxtext.h"
+#include "bufferparams.h"
 #include "BufferView.h"
+#include "gettext.h"
+#include "lengthcommon.h"
+#include "lyxtext.h"
 
+#include "support/convert.h"
 #include "support/lstrings.h"
 
-#include <cstdio>
+
+namespace lyx {
+
+using support::compare;
+using support::isStrDbl;
+using support::ltrim;
+using support::prefixIs;
+using support::rtrim;
+
+using std::string;
 
 
 namespace {
 
-double           number[4] = { 0, 0, 0, 0 };
-LyXLength::UNIT unit[4]   = { LyXLength::UNIT_NONE,
-                             LyXLength::UNIT_NONE,
-                             LyXLength::UNIT_NONE,
-                             LyXLength::UNIT_NONE };
+/// used to return numeric values in parsing vspace
+double number[4] = { 0, 0, 0, 0 };
+/// used to return unit types in parsing vspace
+LyXLength::UNIT unit[4] = { LyXLength::UNIT_NONE,
+                           LyXLength::UNIT_NONE,
+                           LyXLength::UNIT_NONE,
+                           LyXLength::UNIT_NONE };
 
+/// the current position in the number array
 int number_index;
+/// the current position in the unit array
 int unit_index;
 
+/// skip n characters of input
 inline
 void lyx_advance(string & data, string::size_type n)
 {
@@ -45,86 +56,115 @@ void lyx_advance(string & data, string::size_type n)
 }
 
 
+/// return true when the input is at the end
 inline
 bool isEndOfData(string const & data)
 {
-       return frontStrip(data).empty();
+       return ltrim(data).empty();
 }
 
 
+/**
+ * nextToken -  return the next token in the input
+ * @param data input string
+ * @return a char representing the type of token returned
+ *
+ * The possible return values are :
+ *     +       stretch indicator for glue length
+ *     -       shrink indicator for glue length
+ *     n       a numeric value (stored in number array)
+ *     u       a unit type (stored in unit array)
+ *     E       parse error
+ */
 char nextToken(string & data)
 {
-       data = frontStrip(data);
+       data = ltrim(data);
+
        if (data.empty())
                return '\0';
-       else if (data[0] == '+') {
+
+       if (data[0] == '+') {
                lyx_advance(data, 1);
                return '+';
-       } else if (prefixIs(data, "plus")) {
+       }
+
+       if (prefixIs(data, "plus")) {
                lyx_advance(data, 4);
                return '+';
-       } else if (data[0] == '-') {
+       }
+
+       if (data[0] == '-') {
                lyx_advance(data, 1);
                return '-';
-       } else if (prefixIs(data, "minus")) {
+       }
+
+       if (prefixIs(data, "minus")) {
                lyx_advance(data, 5);
                return '-';
-       } else {
-               string::size_type i = data.find_first_not_of("0123456789.");
+       }
 
-               if (i != 0) {
-                       if (number_index > 3) return 'E';
+       string::size_type i = data.find_first_not_of("0123456789.");
 
-                       string buffer;
-               
-                       // we have found some number
-                       if (i == string::npos) {
-                               buffer = data;
-                               i = data.size() + 1;
-                       } else
-                               buffer = data.substr(0, i);
+       if (i != 0) {
+               if (number_index > 3)
+                       return 'E';
 
-                       lyx_advance(data, i);
+               string buffer;
+
+               // we have found some number
+               if (i == string::npos) {
+                       buffer = data;
+                       i = data.size() + 1;
+               } else
+                       buffer = data.substr(0, i);
 
-                       if (isStrDbl(buffer)) {
-                               number[number_index] = strToDbl(buffer);
-                               ++number_index;
-                               return 'n';
-                       } else return 'E';
+               lyx_advance(data, i);
+
+               if (isStrDbl(buffer)) {
+                       number[number_index] = convert<double>(buffer);
+                       ++number_index;
+                       return 'n';
+               }
+               return 'E';
+       }
+
+       i = data.find_first_not_of("abcdefghijklmnopqrstuvwxyz%");
+       if (i != 0) {
+               if (unit_index > 3)
+                       return 'E';
+
+               string buffer;
+
+               // we have found some alphabetical string
+               if (i == string::npos) {
+                       buffer = data;
+                       i = data.size() + 1;
+               } else
+                       buffer = data.substr(0, i);
+
+               // possibly we have "mmplus" string or similar
+               if (buffer.size() > 5 &&
+                               (buffer.substr(2, 4) == string("plus") ||
+                                buffer.substr(2, 5) == string("minus")))
+               {
+                       lyx_advance(data, 2);
+                       unit[unit_index] = unitFromString(buffer.substr(0, 2));
+               } else {
+                       lyx_advance(data, i);
+                       unit[unit_index] = unitFromString(buffer);
                }
-               
-               i = data.find_first_not_of("abcdefghijklmnopqrstuvwxyz%");
-               if (i != 0) {
-                       if (unit_index > 3) return 'E';
-
-                       string buffer;
-               
-                       // we have found some alphabetical string
-                       if (i == string::npos) {
-                               buffer = data;
-                               i = data.size() + 1;
-                       } else
-                               buffer = data.substr(0, i);
-
-                       // possibly we have "mmplus" string or similar
-                       if (buffer.size() > 5 && (buffer.substr(2,4) == string("plus") || buffer.substr(2,5) == string("minus"))) {
-                               lyx_advance(data, 2);
-                               unit[unit_index] = unitFromString(buffer.substr(0, 2));
-                       } else {
-                               lyx_advance(data, i);
-                               unit[unit_index] = unitFromString(buffer);
-                       }
-
-                       if (unit[unit_index] != LyXLength::UNIT_NONE) {
-                               ++unit_index;
-                               return 'u';
-                       } else return 'E';  // Error
+
+               if (unit[unit_index] != LyXLength::UNIT_NONE) {
+                       ++unit_index;
+                       return 'u';
                }
                return 'E';  // Error
        }
+       return 'E';  // Error
 }
 
 
+/// latex representation of a vspace
 struct LaTeXLength {
        char const * pattern;
        int  plus_val_index;
@@ -134,6 +174,7 @@ struct LaTeXLength {
 };
 
 
+/// the possible formats for a vspace string
 LaTeXLength table[] = {
        { "nu",       0, 0, 0, 0 },
        { "nu+nu",    2, 0, 2, 0 },
@@ -156,7 +197,7 @@ LaTeXLength table[] = {
 
 const char * stringFromUnit(int unit)
 {
-       if (unit < 0 || unit >= num_units)
+       if (unit < 0 || unit > num_units)
                return 0;
        return unit_name[unit];
 }
@@ -182,7 +223,7 @@ bool isValidGlueLength(string const & data, LyXGlueLength * result)
 
        if (data.empty())
                return true;
-       string buffer = frontStrip(data);
+       string buffer = ltrim(data);
 
        // To make isValidGlueLength recognize negative values as
        // the first number this little hack is needed:
@@ -194,13 +235,12 @@ bool isValidGlueLength(string const & data, LyXGlueLength * result)
                break;
        case '+':
                lyx_advance(buffer, 1);
-               // fall through
+               break;
        default:
-               // no action
                break;
        }
        // end of hack
-       
+
        int  pattern_index = 0;
        int  table_index = 0;
        char pattern[20];
@@ -224,7 +264,7 @@ bool isValidGlueLength(string const & data, LyXGlueLength * result)
                if (!*table[table_index].pattern)
                        return false;
        }
-       
+
        // Get the values from the appropriate places.  If an index
        // is zero, the corresponding array value is zero or UNIT_NONE,
        // so we needn't check this.
@@ -242,10 +282,10 @@ bool isValidGlueLength(string const & data, LyXGlueLength * result)
 
 bool isValidLength(string const & data, LyXLength * result)
 {
-       /// This is a trimmed down version of isValidGlueLength.
-       /// The parser may seem overkill for lengths without
-       /// glue, but since we already have it, using it is
-       /// easier than writing something from scratch.
+       // This is a trimmed down version of isValidGlueLength.
+       // The parser may seem overkill for lengths without
+       // glue, but since we already have it, using it is
+       // easier than writing something from scratch.
        if (data.empty())
                return true;
 
@@ -269,14 +309,14 @@ bool isValidLength(string const & data, LyXLength * result)
                break;
        }
        // end of hack
-       
+
        number_index = unit_index = 1;  // entries at index 0 are sentinels
 
        // construct "pattern" from "data"
-       while (!isEndOfData (buffer)) {
+       while (!isEndOfData(buffer)) {
                if (pattern_index > 2)
                        return false;
-               pattern[pattern_index] = nextToken (buffer);
+               pattern[pattern_index] = nextToken(buffer);
                if (pattern[pattern_index] == 'E')
                        return false;
                ++pattern_index;
@@ -284,8 +324,8 @@ bool isValidLength(string const & data, LyXLength * result)
        pattern[pattern_index] = '\0';
 
        // only the most basic pattern is accepted here
-       if (compare(pattern, "nu") != 0) return false;          
-       
+       if (compare(pattern, "nu") != 0) return false;
+
        // It _was_ a correct length string.
        // Store away the values we found.
        if (result) {
@@ -301,7 +341,7 @@ bool isValidLength(string const & data, LyXLength * result)
 //
 
 VSpace::VSpace()
-       : kind_(NONE), len_(), keep_(false)
+       : kind_(DEFSKIP), len_(), keep_(false)
 {}
 
 
@@ -321,32 +361,38 @@ VSpace::VSpace(LyXGlueLength const & l)
 
 
 VSpace::VSpace(string const & data)
-       : kind_(NONE), len_(), keep_(false)
+       : kind_(DEFSKIP), len_(), keep_(false)
 {
        if (data.empty())
                return;
-       double value;
-       string input  = strip(data);
+
+       string input = rtrim(data);
 
        string::size_type const length = input.length();
 
-       if (length > 1 && input[length-1] == '*') {
+       if (length > 1 && input[length - 1] == '*') {
                keep_ = true;
                input.erase(length - 1);
        }
 
-       if      (prefixIs (input, "defskip"))    kind_ = DEFSKIP;
-       else if (prefixIs (input, "smallskip"))  kind_ = SMALLSKIP;
-       else if (prefixIs (input, "medskip"))    kind_ = MEDSKIP;
-       else if (prefixIs (input, "bigskip"))    kind_ = BIGSKIP;
-       else if (prefixIs (input, "vfill"))      kind_ = VFILL;
-       else if (isValidGlueLength(input, &len_)) kind_ = LENGTH;
-       else if (sscanf(input.c_str(), "%lf", &value) == 1) {
+       if (prefixIs(input, "defskip"))
+               kind_ = DEFSKIP;
+       else if (prefixIs(input, "smallskip"))
+               kind_ = SMALLSKIP;
+       else if (prefixIs(input, "medskip"))
+               kind_ = MEDSKIP;
+       else if (prefixIs(input, "bigskip"))
+               kind_ = BIGSKIP;
+       else if (prefixIs(input, "vfill"))
+               kind_ = VFILL;
+       else if (isValidGlueLength(input, &len_))
+               kind_ = LENGTH;
+       else if (isStrDbl(input)) {
                // This last one is for reading old .lyx files
                // without units in added_space_top/bottom.
                // Let unit default to centimeters here.
                kind_ = LENGTH;
-               len_  = LyXGlueLength(LyXLength(value, LyXLength::CM));
+               len_  = LyXGlueLength(LyXLength(convert<double>(input), LyXLength::CM));
        }
 }
 
@@ -357,7 +403,7 @@ VSpace::vspace_kind VSpace::kind() const
 }
 
 
-LyXGlueLength VSpace::length() const
+LyXGlueLength const & VSpace::length() const
 {
        return len_;
 }
@@ -394,7 +440,6 @@ string const VSpace::asLyXCommand() const
 {
        string result;
        switch (kind_) {
-       case NONE:      break;
        case DEFSKIP:   result = "defskip";      break;
        case SMALLSKIP: result = "smallskip";    break;
        case MEDSKIP:   result = "medskip";      break;
@@ -402,7 +447,7 @@ string const VSpace::asLyXCommand() const
        case VFILL:     result = "vfill";        break;
        case LENGTH:    result = len_.asString(); break;
        }
-       if (keep_ && kind_ != NONE && kind_ != DEFSKIP)
+       if (keep_)
                result += '*';
        return result;
 }
@@ -411,50 +456,94 @@ string const VSpace::asLyXCommand() const
 string const VSpace::asLatexCommand(BufferParams const & params) const
 {
        switch (kind_) {
-       case NONE:      return string();
        case DEFSKIP:
                return params.getDefSkip().asLatexCommand(params);
-       case SMALLSKIP: return keep_ ? "\\vspace*{\\smallskipamount}"
-                               : "\\smallskip{}";
-       case MEDSKIP:   return keep_ ? "\\vspace*{\\medskipamount}"
-                               : "\\medskip{}";
-       case BIGSKIP:   return keep_ ? "\\vspace*{\\bigskipamount}"
-                               : "\\bigskip{}";
-       case VFILL:     return keep_ ? "\\vspace*{\\fill}"
-                               : "\\vfill{}";
-       case LENGTH:    return keep_ ? "\\vspace*{" + len_.asLatexString() + '}'
-                               : "\\vspace{" + len_.asLatexString() + '}';
+
+       case SMALLSKIP:
+               return keep_ ? "\\vspace*{\\smallskipamount}" : "\\smallskip{}";
+
+       case MEDSKIP:
+               return keep_ ? "\\vspace*{\\medskipamount}" : "\\medskip{}";
+
+       case BIGSKIP:
+               return keep_ ? "\\vspace*{\\bigskipamount}" : "\\bigskip{}";
+
+       case VFILL:
+               return keep_ ? "\\vspace*{\\fill}" : "\\vfill{}";
+
+       case LENGTH:
+               return keep_ ? "\\vspace*{" + len_.asLatexString() + '}'
+                       : "\\vspace{" + len_.asLatexString() + '}';
+
+       default:
+               BOOST_ASSERT(false);
+               return string();
        }
-       return string();  // should never be reached
 }
 
 
-int VSpace::inPixels(BufferView * bv) const
+docstring const VSpace::asGUIName() const
+{
+       docstring result;
+       switch (kind_) {
+       case DEFSKIP:
+               result = _("Default skip");
+               break;
+       case SMALLSKIP:
+               result = _("Small skip");
+               break;
+       case MEDSKIP:
+               result = _("Medium skip");
+               break;
+       case BIGSKIP:
+               result = _("Big skip");
+               break;
+       case VFILL:
+               result = _("Vertical fill");
+               break;
+       case LENGTH:
+               result = from_ascii(len_.asString());
+               break;
+       }
+       if (keep_)
+               result += ", " + _("protected");
+       return result;
+}
+
+
+int VSpace::inPixels(BufferView const & bv) const
 {
        // Height of a normal line in pixels (zoom factor considered)
-       int default_height = bv->text->defaultHeight(); // [pixels]
-       int default_width  = bv->workWidth();
+       int const default_height = defaultRowHeight();
 
        switch (kind_) {
-       case NONE:
-               return 0;
+
        case DEFSKIP:
-               return bv->buffer()->params.getDefSkip().inPixels(bv);
+               return bv.buffer()->params().getDefSkip().inPixels(bv);
 
-               // This is how the skips are normally defined by
-               // LateX.  But there should be some way to change
-               // this per document.
+       // This is how the skips are normally defined by LateX.
+       // But there should be some way to change this per document.
        case SMALLSKIP:
                return default_height / 4;
+
        case MEDSKIP:
                return default_height / 2;
+
        case BIGSKIP:
                return default_height;
 
        case VFILL:
                // leave space for the vfill symbol
                return 3 * default_height;
+
        case LENGTH:
-               return len_.len().inPixels(default_width, default_height);
+               return len_.len().inPixels(bv.workWidth());
+
+       default:
+               BOOST_ASSERT(false);
+               return 0;
        }
 }
+
+
+} // namespace lyx