# parseFilePath(path)

The `parseFilePath()` function resolves a relative file path into an absolute path, handling various file locations including user directories, packages, and current workspace paths.

```javascript
// Resolve a relative path to an absolute path
absolutePath = parseFilePath("myFolder/file.osl")
```

## Syntax

```javascript
parseFilePath(path)
```

## Parameters

* `path`: String - A relative or partial file path to resolve

## Return Value

Returns a string containing the resolved absolute file path.

## Description

The `parseFilePath()` function takes a relative or partial file path and resolves it to a complete absolute path, taking into account the current working directory, user directories, and package locations. This function is useful for:

* Resolving file paths before file operations
* Working with imports and includes
* Handling user files and packages consistently
* Navigating directory structures programmatically

The function handles various path formats and locations, making it easier to work with files across different contexts in the OSL environment.

## Examples

### Basic Usage

```javascript
// Resolve a simple file in the current directory
filePath = parseFilePath("config.json")
log filePath  // Full absolute path to config.json

// Resolve a file in a subdirectory
imagePath = parseFilePath("assets/images/logo.png")
log imagePath  // Full absolute path to the image
```

### Working with Package Files

```javascript
// Resolve a path to a package file
packagePath = parseFilePath("packages/utils/helpers.osl")
log packagePath  // Absolute path to the package file
```

### Using with File Operations

```javascript
// Resolve a path before reading a file
configPath = parseFilePath("config/settings.json")
configData = open(configPath, ["data"])

// Work with the file data
settings = configData[1]
```

### Path Manipulation

```javascript
// Get the directory containing a file
filePath = parseFilePath("documents/report.txt")
dirPath = filePath.replaceFirst(/\/[^\/]+$/, "")

// List files in that directory
files = listFiles(dirPath)
```

## Notes

* The function resolves paths relative to the current working directory by default
* Special directories like user directories and package locations are handled automatically
* The function does not verify if the file actually exists
* For security reasons, the function may prevent accessing paths outside allowed directories
* The resolved path follows the platform-specific format for the current environment


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://osl.mistium.com/functions/parsefilepath.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.