DirTree Dart Reference Documentation

CkDirTree

Current Version: 11.6.1

Chilkat.DirTree

Iterate through files and subdirectories under a base directory.

Chilkat.DirTree is a lightweight directory-tree iterator for traversing files and subdirectories under a selected base directory. It supports recursive and non-recursive traversal and exposes useful information about the current item, including absolute path, UNC path, relative path, file size, and whether the current item is a directory.

Directory traversal

Iterate through the contents of a base directory, either recursively or one level at a time.

Current-item details

Get the current item's full path, relative path, UNC path, size, and directory/file status.

Recursive scanning

Traverse entire directory trees when an application needs to process all nested files and folders.

Non-recursive listing

Limit iteration to the immediate contents of the base directory when deeper traversal is not needed.

Path-friendly output

Use absolute or relative paths depending on whether the application needs filesystem access or archive-style relative names.

Error-aware iteration

Use DoneIterating to distinguish normal completion from an error when an iteration method returns false.

Common pattern: Set the base directory and recursion behavior, begin iterating, process each current item using the path and metadata properties, then check DoneIterating when iteration stops to determine whether traversal completed normally or ended because of an error.

For an extended overview, see DirTree Class Overview.

Object Creation

// pubspec.yaml:
//     dependencies:
//       chilkat: ^11.6.1

import 'package:chilkat/chilkat.dart';

// Once per process, before any other Chilkat call:
Chilkat.unlockBundle('Anything for 30-day trial');   // shorthand for CkGlobal().unlockBundle(..)

final dirTree = CkDirTree();
// ... the native object is released when `dirTree` is garbage collected, or now with dirTree.dispose().

CkDirTree CkDirTree()

Creates the underlying native Chilkat object. Use a CkDirTree only from the isolate that created it: Chilkat objects cannot be sent between isolates. Every call is synchronous; in a Flutter app, run long operations (network, large files) inside Isolate.run, creating the Chilkat objects inside the isolate.

void dispose()

Releases the native object immediately instead of waiting for garbage collection (useful for a large CkBinData or an open socket). Calling it more than once is harmless; any other use of the object afterwards throws a StateError. isDisposed tells whether it has been called.

Errors

A method that can fail throws a ChilkatException: a method whose only outcome is success or failure returns void and throws on failure; a method producing a String or an object returns it and throws where Chilkat would have returned null. The exception carries the object's LastErrorText at the time of the failure (lastErrorText), the class and method names (className, methodName) and a one-line message. Properties never throw, and methods that answer a question (has..., is..., ...) return a plain bool.

try {
  dirTree.someMethod(...);
} on ChilkatException catch (e) {
  print(e);                // CkDirTree.someMethod failed: <reason>
  print(e.lastErrorText);  // the full Chilkat log of the failed call
}

Properties

BaseDir

// read/write
String get baseDir
set baseDir(String value)

Specifies the root directory whose contents are traversed. Set this property before calling BeginIterate.

The value may be an absolute filesystem path or a relative path. A relative path is resolved from the calling process's current working directory.

Iteration scope: The iterator visits the files and subdirectories contained under this directory. The Recurse property determines whether nested levels are included.

More Information and Examples

Iterate over Files and Directories in Filesystem Directory Tree

Method result	`DoneIterating`	Meaning
`false`	`true`	The directory was empty, or the last item has been passed. This is normal completion.
`false`	`false`	An error occurred. Examine `LastErrorText`.

`true`	Visit files and directories throughout the complete tree rooted at `BaseDir`.
`false`	Visit only the immediate contents of `BaseDir`.

Return value	`DoneIterating`	Meaning
`true`	`false`	The iterator advanced successfully and a current item is available.
`false`	`true`	The last item has been passed; traversal completed normally.
`false`	`false`	An error occurred. Examine `LastErrorText`.

Return value	`DoneIterating`	Meaning
`true`	`false`	The first item is available.
`false`	`true`	The directory contains no items in the selected traversal scope. This is not an error.
`false`	`false`	Initialization failed. Examine `LastErrorText`.

DirTree Dart Reference Documentation

CkDirTree

Current Version: 11.6.1

Iterate through files and subdirectories under a base directory.

Directory traversal

Current-item details

Recursive scanning

Non-recursive listing

Path-friendly output

Error-aware iteration

Object Creation

Errors

Properties

BaseDir

DebugLogFilePath

DoneIterating

FileSize32

FileSize64

FileSizeStr

FullPath

FullUncPath

IsDirectory

LastErrorHtml

LastErrorText

LastErrorXml

LastMethodSuccess

Recurse

RelativePath

UncommonOptions

VerboseLogging

Version

Methods

AdvancePosition

BeginIterate