n_http_response.h

Go to the documentation of this file.

/*
 * Nilorea Library
 * Copyright (C) 2005-2026 Castagnier Mickael
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * permissions and limitations under the License.
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef __NILOREA_HTTP_RESPONSE_HEADER
#define __NILOREA_HTTP_RESPONSE_HEADER
 
#ifdef __cplusplus
extern "C" {
#endif

 
#include "nilorea/n_str.h"
 
#include <stddef.h>
#include <sys/types.h>

#define N_HTTP_RESPONSE_HEADERS_MAX 64
#define N_HTTP_RESPONSE_VALUE_MAX 8192

typedef ssize_t (*n_http_write_fn)(void* ctx, const void* buf, size_t len);

typedef struct N_HTTP_RESP {
    int status;
    char* names[N_HTTP_RESPONSE_HEADERS_MAX];
    char* values[N_HTTP_RESPONSE_HEADERS_MAX];
    size_t nb_headers;
    N_STR* body;
    int fd;
    long long fd_offset;
    long long fd_length;
    int head_only;
    int keep_alive;
    int version_minor;
} N_HTTP_RESP;

const char* n_http_status_reason(int status);

N_HTTP_RESP* n_http_response_new(int status);

void n_http_response_free(N_HTTP_RESP** r);

int n_http_response_set_status(N_HTTP_RESP* r, int status);

int n_http_response_add_header(N_HTTP_RESP* r, const char* name, const char* value);

int n_http_response_set_header(N_HTTP_RESP* r, const char* name, const char* value);

size_t n_http_response_remove_header(N_HTTP_RESP* r, const char* name);

const char* n_http_response_get_header(const N_HTTP_RESP* r, const char* name);

int n_http_response_append(N_HTTP_RESP* r, const void* data, size_t len);

int n_http_response_file(N_HTTP_RESP* r, int fd, long long offset, long long length);

int n_http_response_set_connection(N_HTTP_RESP* r, int keep_alive, int version_minor, int head_only);

long long n_http_response_body_length(const N_HTTP_RESP* r);

int n_http_response_head(const N_HTTP_RESP* r, N_STR** out);

int n_http_response_write(const N_HTTP_RESP* r, n_http_write_fn fn, void* ctx);

typedef enum {
    N_HTTP_RANGE_NONE = 0,         
    N_HTTP_RANGE_OK = 1,           
    N_HTTP_RANGE_UNSATISFIABLE = 2 
} N_HTTP_RANGE;

N_HTTP_RANGE n_http_parse_range(const char* value, size_t len, long long total, long long* first, long long* last);

 
#ifdef __cplusplus
}
#endif
 
#endif /* __NILOREA_HTTP_RESPONSE_HEADER */