glib/org.gtkkn.bindings.glib/PathBuf

PathBuf

class PathBuf(pointer: <Error class: unknown class><<Error class: unknown class>>) : Record

GPathBuf is a helper type that allows you to easily build paths from individual elements, using the platform specific conventions for path separators.

g_auto (GPathBuf) path;

g_path_buf_init (&path);

g_path_buf_push (&path, "usr");
g_path_buf_push (&path, "bin");
g_path_buf_push (&path, "echo");

g_autofree char *echo = g_path_buf_to_path (&path);
g_assert_cmpstr (echo, ==, "/usr/bin/echo");

You can also load a full path and then operate on its components:

g_auto (GPathBuf) path;

g_path_buf_init_from_path (&path, "/usr/bin/echo");

g_path_buf_pop (&path);
g_path_buf_push (&path, "sh");

g_autofree char *sh = g_path_buf_to_path (&path);
g_assert_cmpstr (sh, ==, "/usr/bin/sh");

Skipped during bindings generation

parameter v1: gpointer
field dummy: Record field dummy is private

Since

2.76

Constructors

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

object Companion : RecordCompanion<PathBuf, <Error class: unknown class>>

Properties

glibPathBufPointer

val glibPathBufPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

fun clear()

Clears the contents of the path buffer.

fun clearToPath(): String?

Clears the contents of the path buffer and returns the built path.

fun free()

Frees a GPathBuf allocated by g_path_buf_new().

fun freeToPath(): String?

Frees a GPathBuf allocated by g_path_buf_new(), and returns the path inside the buffer.

fun init(): PathBuf

Initializes a GPathBuf instance.

fun initFromPath(path: String? = null): PathBuf

Initializes a GPathBuf instance with the given path.

fun pop(): Boolean

Removes the last element of the path buffer.

fun push(path: String): PathBuf

Extends the given path buffer with @path.

fun setExtension(extension: String? = null): Boolean

Adds an extension to the file name in the path buffer.

fun setFilename(fileName: String): Boolean

Sets the file name of the path.

fun toPath(): String?

Retrieves the built path from the path buffer.