Reference

Basics

These are some basic, helpful functions available in the library. The basename is the last portion of the path which determines the name of the file or folder which is being pointed to. For instance, the path /var/log/test.txt would have the basename test.txt. The dirname is the opposite - the path up to the basename. In that example the dirname would be /var/log.

Functions

• cwk_path_get_basename
  Gets the basename of a file path.

• cwk_path_change_basename
  Changes the basename of a file path.

• cwk_path_get_dirname
  Gets the dirname of a file path.

• cwk_path_get_root
  Determines the root of a path.

• cwk_path_change_root
  Changes the root of a path.

• cwk_path_is_absolute
  Determine whether the path is absolute or not.

• cwk_path_is_relative
  Determine whether the path is relative or not.

• cwk_path_join
  Joins two paths together.

• cwk_path_join_multiple
  Joins multiple paths together.

• cwk_path_normalize
  Creates a normalized version of the path.

• cwk_path_intersection
  Finds common portions in two paths.

Navigation

One might specify paths containing relative components ../. These functions help to resolve or create relative paths based on a base path.

Functions

• cwk_path_get_absolute
  Generates an absolute path based on a base.

• cwk_path_get_relative
  Generates a relative path based on a base.

Extensions

Extensions are the portion of a path which come after a .. For instance, the file extension of the /var/log/test.txt would be .txt - which indicates that the content is text.

Functions

• cwk_path_get_extension
  Gets the extension of a file path.

• cwk_path_has_extension
  Determines whether the file path has an extension.

• cwk_path_change_extension
  Changes the extension of a file path.

Segments

A segment represents a single component of a path. For instance, on linux a path might look like this /var/log/, which consists of two segments var and log.

Functions

• cwk_path_get_first_segment
  Gets the first segment of a path.

• cwk_path_get_last_segment
  Gets the last segment of the path.

• cwk_path_get_next_segment
  Advances to the next segment.

• cwk_path_get_previous_segment
  Moves to the previous segment.

• cwk_path_get_segment_type
  Gets the type of the submitted path segment.

• cwk_path_change_segment
  Changes the content of a segment.

Style

The path style describes how paths are generated and parsed. cwalk currently supports two path styles, CWK_STYLE_WINDOWS and CWK_STYLE_UNIX.

Functions

• cwk_path_guess_style
  Guesses the path style.

• cwk_path_set_style
  Configures which path style is used.

• cwk_path_get_style
  Gets the path style configuration.