another safety belt

[lyx.git] / src / support / textutils.h

diff --git a/src/support/textutils.h b/src/support/textutils.h
index 87369e7933ed0ce660be3971cf6ab63588493546..3a239da1337bb6723ddcee61aa7ae978f1148ed6 100644 (file)
--- a/src/support/textutils.h
+++ b/src/support/textutils.h
@@ -1,71 +1,65 @@
 // -*- C++ -*-
-/* This file is part of
- * ======================================================
- * 
- *           LyX, The Document Processor
- *      
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2000 The LyX Team.
+/**
+ * \file textutils.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- * ====================================================== */
+ * \author Matthias Ettrich
+ * \author Lars Gullik Bjønnes
+ *
+ * Full author contact details are available in file CREDITS
+ */
+
+// FIXME: I can think of a better name for this file ...
 
 #ifndef TEXTUTILS_H
 #define TEXTUTILS_H
 
-#include <cctype>
-
-//
+/// return true if the char is a meta-character newline
 inline
-bool IsNewlineChar(char c) {
-       return (c == LyXParagraph::META_NEWLINE);
+bool IsNewlineChar(char c)
+{
+       return (c == Paragraph::META_NEWLINE);
 }
 
 
-//
+/// return true if the char is a word separator
 inline
-bool IsSeparatorChar(char c) {
+bool IsSeparatorChar(char c)
+{
        return (c == ' ');
 }
 
 
-//
+/// return true if the char is a line separator
 inline
-bool IsHfillChar(char c) {
-       return (c == LyXParagraph::META_HFILL);
-}
-
-
-//
-inline
-bool IsInsetChar(char c) {
-       return (c == LyXParagraph::META_INSET);
+bool IsLineSeparatorChar(char c)
+{
+       return (c == ' ');
 }
 
 
-//
+/// return true if the char is a meta-character for hfill
 inline
-bool IsFloatChar(char c) {
-       return (c == LyXParagraph::META_FOOTNOTE
-               || c == LyXParagraph::META_MARGIN
-               || c == LyXParagraph::META_FIG
-               || c == LyXParagraph::META_TAB
-               || c == LyXParagraph::META_ALGORITHM
-               || c == LyXParagraph::META_WIDE_FIG
-               || c == LyXParagraph::META_WIDE_TAB);
+bool IsHfillChar(char c)
+{
+       return (c == Paragraph::META_HFILL);
 }
 
 
-//
+/// return true if the char is a meta-character for an inset
 inline
-bool IsLineSeparatorChar(char c) {
-       return (c == ' ');
+bool IsInsetChar(char c)
+{
+       return (c == Paragraph::META_INSET);
 }
 
 
-//
+/// return true if the char is "punctuation"
 inline
-bool IsKommaChar(char c) {
-       return (c == ',' 
+bool IsKommaChar(char c)
+{
+       return (c == ','
                || c == '('
                || c == ')'
                || c == '['
@@ -86,51 +80,63 @@ bool IsKommaChar(char c) {
                || c == '#'
                || c == '%'
                || c == '^'
-               || c == '/' 
+               || c == '/'
                || c == '\\'
-               || c == LyXParagraph::META_NEWLINE
+               || c == Paragraph::META_NEWLINE
                );
 }
 
 
-//
+/// return true if a char is alphabetical (including accented chars)
 inline
-bool IsLetterChar(unsigned char c) {
+bool IsLetterChar(unsigned char c)
+{
        return ((c >= 'A' && c <= 'Z')
                || (c >= 'a' && c <= 'z')
                || (c >= 192)); // in iso-8859-x these are accented chars
 }
 
 
-//
+/// return true if the char is printable (masked to 7-bit ASCII)
+inline
+bool IsPrintable(unsigned char c)
+{
+       return ((c & 127) >= ' ');
+}
+
+
+/// return true if the char is printable and not a space (masked to 7-bit ASCII)
 inline
-bool IsPrintable(unsigned char c) {
-       return (c >= ' ');
+bool IsPrintableNonspace(unsigned char c)
+{
+       return IsPrintable(c) && (c != ' ');
 }
 
 
-//
+/// return true if the char forms part of a word
 inline
-bool IsPrintableNonspace(unsigned char c) {
-       return (c > ' ');
+bool IsWordChar(unsigned char c)
+{
+       return !(IsSeparatorChar(c)
+                 || IsKommaChar(c)
+                 || IsHfillChar(c)
+                 || IsInsetChar(c));
 }
 
 
-// Word is not IsSeparator or IsKomma or IsHfill or IsFloat or IsInset. 
+/// completely pointless FIXME
 inline
-bool IsWordChar(unsigned char c) {
-       return !( IsSeparatorChar( c ) 
-                 || IsKommaChar( c )  
-                 || IsHfillChar( c )  
-                 || IsFloatChar( c )  
-                 || IsInsetChar( c ) ) ;
+bool IsDigit(unsigned char ch)
+{
+       return ch >= '0' && ch <= '9';
 }
 
 
-//
+/// return true if the char is alphanumeric
 inline
-bool IsLetterCharOrDigit(char ch)
+bool IsLetterCharOrDigit(unsigned char ch)
 {
-       return IsLetterChar(ch) || isdigit(ch);
+       return IsLetterChar(ch) || IsDigit(ch);
 }
-#endif
+
+#endif // TEXTUTILS_H