## SoupCookieJarText

SoupCookieJarText — Text-file-based ("cookies.txt") Cookie Jar

## Synopsis

    #include <libsoup/soup.h>

                        SoupCookieJarText;
    SoupCookieJar *     soup_cookie_jar_text_new            (const char *filename,
                                                             gboolean read_only);

    #define             SOUP_COOKIE_JAR_TEXT_FILENAME

## Object Hierarchy

      GObject
       +----SoupCookieJar
             +----SoupCookieJarText

## Implemented Interfaces

SoupCookieJarText implements SoupSessionFeature.

## Properties

      "filename"                 gchar*                : Read / Write / Construct Only

## Description

SoupCookieJarText is a SoupCookieJar that reads cookies from and writes them to a text file in the Mozilla "cookies.txt" format.

## Details

### SoupCookieJarText

    typedef struct _SoupCookieJarText SoupCookieJarText;

### soup_cookie_jar_text_new ()

    SoupCookieJar *     soup_cookie_jar_text_new            (const char *filename,
                                                             gboolean read_only);

Creates a SoupCookieJarText.

`filename` will be read in at startup to create an initial set of cookies. If `read_only` is `FALSE`, then the non-session cookies will be written to `filename` when the 'changed' signal is emitted from the jar. (If `read_only` is `TRUE`, then the cookie jar will only be used for this session, and changes made to it will be lost when the jar is destroyed.)

`filename` : | the filename to read to/write from
`read_only` : | `TRUE` if `filename` is read-only
Returns : | the new SoupCookieJar

Since 2.26

### SOUP_COOKIE_JAR_TEXT_FILENAME

    #define SOUP_COOKIE_JAR_TEXT_FILENAME  "filename"

Alias for the "filename" property. (The cookie-storage filename.)

## Property Details

### The `"filename"` property

      "filename"                 gchar*                : Read / Write / Construct Only

Cookie-storage filename.

Default value: NULL