summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorDuncan Gibson <engelsman@users.noreply.github.com>2020-07-25 10:44:24 +0200
committerAlbrecht Schlosser <albrechts.fltk@online.de>2021-08-28 15:12:38 +0200
commit6d78015071ecd755e027a3edc4a890d432a57c9d (patch)
tree9c4d3598d941bc72a37a8796b6fc34e58c1dcbe5 /src
parent29a56f87e3bd919a581e3ce001b3a98753684aac (diff)
add fl_filename_match comments as per STR3186
add Notes: section to fl_filename_match documentation explaining case-sensitivity [or not] and use of \x see also https://www.fltk.org/str.php?L3186
Diffstat (limited to 'src')
-rw-r--r--src/filename_match.cxx11
1 files changed, 9 insertions, 2 deletions
diff --git a/src/filename_match.cxx b/src/filename_match.cxx
index debc9d909..8584bfdc9 100644
--- a/src/filename_match.cxx
+++ b/src/filename_match.cxx
@@ -1,7 +1,7 @@
//
// Pattern matching routines for the Fast Light Tool Kit (FLTK).
//
-// Copyright 1998-2010 by Bill Spitzak and others.
+// Copyright 1998-2020 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
@@ -28,7 +28,14 @@
- [^set] or [!set] matches any character not in the set.
- {X|Y|Z} or {X,Y,Z} matches any one of the subexpressions literally.
- \\x quotes the character x so it has no special meaning.
- - x all other characters must be matched exactly.
+ - x all other characters are matched "exactly" on a \b case-insensitive basis.
+
+ Notes:
+ - \p s and \p p are matched on a char/byte basis, not as UCS codepoints or UTF-8 sequences.
+ - [set] ranges must run from low to high, i.e. [a-z] and not [z-a]
+ - [set] comparison is \b case-sensitive, i.e. [a-z] won't match "A".
+ - \\x only applies to the fl_filename_match special characters * ? [ {
+ - \\x needs a double \\ or the compiler will complain about non-standard escape sequences.
\b Include:
\code