tf.io.gfile.glob

Returns a list of files that match the given pattern(s).

tf.io.gfile.glob(
    pattern
)

The patterns are defined as strings. Supported patterns are defined here. Note that the pattern can be a Python iteratable of string patterns.

The format definition of the pattern is:

pattern: { term }

term:

  • '*': matches any sequence of non-'/' characters
  • '?': matches a single non-'/' character
  • '[' [ '^' ] { match-list } ']': matches any single character (not) on the list
  • c: matches character c where c != '*', '?', '\\', '['
  • '\\' c: matches character c

character range:

  • c: matches character c while c != '\\', '-', ']'
  • '\\' c: matches character c
  • lo '-' hi: matches character c for lo <= c <= hi

Examples:

tf.io.gfile.glob("*.py")
# For example, ['__init__.py']
 
tf.io.gfile.glob("__init__.??")
# As above
 
files = {"*.py"}
the_iterator = iter(files)
tf.io.gfile.glob(the_iterator)
# As above

See the C++ function GetMatchingPaths in core/platform/file_system.h for implementation details.

pattern string or iterable of strings. The glob pattern(s).

A list of strings containing filenames that match the given pattern(s).

errors.OpError If there are filesystem / directory listing errors.
errors.NotFoundError If pattern to be matched is an invalid directory.