tf.io.gfile.glob

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

View aliases

Compat aliases for migration

See Migration guide for more details.

tf.compat.v1.io.gfile.glob

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.

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

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

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