cwk_path_get_root

(since v1.0.0)
Determines the root of a path.

Description

void cwk_path_get_root(const char *path, size_t *length);

This function determines the root of a path by finding it’s length. The root comes before the first segment of the path. For example, C:\ is the root of C:\folder\file.txt. It always starts at the submitted path. If the path has no root, the length will be set to zero.

Parameters

• path: The path which will be inspected.
• length: The output of the root length.

Outcomes

Note

The style is automatically chosen during compile time, which is UNIX for macOS and linux and WINDOWS for windows. You can change the style using cwk_path_set_style.

Example

#include <cwalk.h>
#include <stdio.h>
#include <stddef.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
  const char *path;
  size_t length;

  path = "/my/path.txt";
  cwk_path_get_root(path, &length);
  printf("The root is: '%.*s'", length, path);

  return EXIT_SUCCESS;
}

Ouput:

The root is: '/'

Changelog