/usr/include/InsightToolkit/IO/itkRegularExpressionSeriesFileNames.h is in libinsighttoolkit3-dev 3.20.1+git20120521-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | /*=========================================================================
Program: Insight Segmentation & Registration Toolkit
Module: itkRegularExpressionSeriesFileNames.h
Language: C++
Date: $Date$
Version: $Revision$
Copyright (c) Insight Software Consortium. All rights reserved.
See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notices for more information.
=========================================================================*/
#ifndef __itkRegularExpressionSeriesFileNames_h
#define __itkRegularExpressionSeriesFileNames_h
#ifdef _MSC_VER
#pragma warning ( disable : 4786 )
#endif
#include "itkObject.h"
#include "itkObjectFactory.h"
#include "itkExceptionObject.h"
#include <vector>
namespace itk
{
/** \class RegularExpressionSeriesFileNames
* \brief Generate an ordered sequence of filenames that match a
* regular expression.
*
* This class generates an ordered sequence of files whose filenames
* match a regular expression. The file names are sorted using a sub
* expression match selected by SubMatch. Regular expressions are a
* powerful, compact mechanism for parsing strings.
* Expressions consist of the following metacharacters:
*
* ^ Matches at beginning of a line
*
* $ Matches at end of a line
*
* . Matches any single character
*
* [ ] Matches any character(s) inside the brackets
*
* [^ ] Matches any character(s) not inside the brackets
*
* - Matches any character in range on either side of a dash
*
* * Matches preceding pattern zero or more times
*
* + Matches preceding pattern one or more times
*
* ? Matches preceding pattern zero or once only
*
* () Saves a matched expression and uses it in a later match
*
* Note that more than one of these metacharacters can be used
* in a single regular expression in order to create complex
* search patterns. For example, the pattern [^ab1-9] says to
* match any character sequence that does not begin with the
* characters "ab" followed by numbers in the series one
* through nine.
*
* \ingroup IOFilters
*
*/
class ITK_EXPORT RegularExpressionSeriesFileNames : public Object
{
public:
/** Standard class typedefs. */
typedef RegularExpressionSeriesFileNames Self;
typedef Object Superclass;
typedef SmartPointer<Self> Pointer;
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** Run-time type information (and related methods). */
itkTypeMacro(RegularExpressionSeriesFileNames, Object);
/* -------- Define the API for RegularExpressionSeriesFileNames ---------- */
/** The directory containing the files. */
itkSetStringMacro(Directory);
itkGetStringMacro(Directory);
/** The RegularExpression. Refer to the description for valid expressions */
itkSetStringMacro(RegularExpression);
itkGetStringMacro(RegularExpression);
/** The index of the submatch that will be used to sort the
* matches. */
itkSetMacro(SubMatch, unsigned int);
itkGetConstMacro(SubMatch, unsigned int);
/** NumericSortOn changes the sort of the submatch field to a
* numeric sort. NumericSortOff is the default, and sorts the
* submatch alphabetically. */
itkSetMacro(NumericSort,bool);
itkGetConstMacro(NumericSort,bool);
itkBooleanMacro(NumericSort);
/** Returns a vector containing the series' file names. The file
* names are sorted by the sub expression selected by the SubMatch id. */
const std::vector<std::string> &GetFileNames ();
protected:
RegularExpressionSeriesFileNames() :
m_Directory("."),
m_SubMatch(1),
m_NumericSort(false),
m_RegularExpression(".*\\.([0-9]+)")
{};
~RegularExpressionSeriesFileNames() {};
void PrintSelf(std::ostream& os, Indent indent) const;
private:
RegularExpressionSeriesFileNames(const Self&); //purposely not implemented
void operator=(const Self&); //purposely not implemented
std::string m_Directory;
unsigned int m_SubMatch;
bool m_NumericSort;
std::string m_RegularExpression;
std::vector<std::string> m_FileNames;
};
} //namespace ITK
#endif // __itkRegularExpressionSeriesFileNames_h
|