### Function

# Gio File new_for_commandline_arg

#### Declaration

    GFile*
    g_file_new_for_commandline_arg (
      const char* arg
    )

#### Description

Creates a `GFile` with the given argument from the command line. The value of `arg` can be either a URI, an absolute path or a relative path resolved relative to the current working directory. This operation never fails, but the returned object might not support any I/O operation if `arg` points to a malformed path.

Note that on Windows, this function expects its argument to be in UTF-8 — not the system code page. This means that you should not use this function with string from argv as it is passed to main(). `g_win32_get_command_line()` will return a UTF-8 version of the commandline. `GApplication` also uses UTF-8 but `g_application_command_line_create_file_for_arg()` may be more useful for you there. It is also always possible to use this function with `GOptionContext` arguments of type `G_OPTION_ARG_FILENAME`.

#### Parameters

`arg`

  Type: `const char*`

  A command line string.

  The data is owned by the caller of the function.
  The value is a file system path, using the OS encoding.

#### Return value

Type: `GFile`

A new `GFile`. Free the returned object with g_object_unref().

The caller of the function takes ownership of the data, and is responsible for freeing it.