src/http/ngx_http_variables.h - nginx-1.7.10

Data types defined

Macros defined

Source code


  1. /*
  2. * Copyright (C) Igor Sysoev
  3. * Copyright (C) Nginx, Inc.
  4. */


  5. #ifndef _NGX_HTTP_VARIABLES_H_INCLUDED_
  6. #define _NGX_HTTP_VARIABLES_H_INCLUDED_


  7. #include <ngx_config.h>
  8. #include <ngx_core.h>
  9. #include <ngx_http.h>


  10. typedef ngx_variable_value_t  ngx_http_variable_value_t;

  11. #define ngx_http_variable(v)     { sizeof(v) - 1, 1, 0, 0, 0, (u_char *) v }

  12. typedef struct ngx_http_variable_s  ngx_http_variable_t;

  13. typedef void (*ngx_http_set_variable_pt) (ngx_http_request_t *r,
  14.     ngx_http_variable_value_t *v, uintptr_t data);
  15. typedef ngx_int_t (*ngx_http_get_variable_pt) (ngx_http_request_t *r,
  16.     ngx_http_variable_value_t *v, uintptr_t data);


  17. #define NGX_HTTP_VAR_CHANGEABLE   1
  18. #define NGX_HTTP_VAR_NOCACHEABLE  2
  19. #define NGX_HTTP_VAR_INDEXED      4
  20. #define NGX_HTTP_VAR_NOHASH       8


  21. struct ngx_http_variable_s {
  22.     ngx_str_t                     name;   /* must be first to build the hash */
  23.     ngx_http_set_variable_pt      set_handler;
  24.     ngx_http_get_variable_pt      get_handler;
  25.     uintptr_t                     data;
  26.     ngx_uint_t                    flags;
  27.     ngx_uint_t                    index;
  28. };


  29. ngx_http_variable_t *ngx_http_add_variable(ngx_conf_t *cf, ngx_str_t *name,
  30.     ngx_uint_t flags);
  31. ngx_int_t ngx_http_get_variable_index(ngx_conf_t *cf, ngx_str_t *name);
  32. ngx_http_variable_value_t *ngx_http_get_indexed_variable(ngx_http_request_t *r,
  33.     ngx_uint_t index);
  34. ngx_http_variable_value_t *ngx_http_get_flushed_variable(ngx_http_request_t *r,
  35.     ngx_uint_t index);

  36. ngx_http_variable_value_t *ngx_http_get_variable(ngx_http_request_t *r,
  37.     ngx_str_t *name, ngx_uint_t key);

  38. ngx_int_t ngx_http_variable_unknown_header(ngx_http_variable_value_t *v,
  39.     ngx_str_t *var, ngx_list_part_t *part, size_t prefix);


  40. #if (NGX_PCRE)

  41. typedef struct {
  42.     ngx_uint_t                    capture;
  43.     ngx_int_t                     index;
  44. } ngx_http_regex_variable_t;


  45. typedef struct {
  46.     ngx_regex_t                  *regex;
  47.     ngx_uint_t                    ncaptures;
  48.     ngx_http_regex_variable_t    *variables;
  49.     ngx_uint_t                    nvariables;
  50.     ngx_str_t                     name;
  51. } ngx_http_regex_t;


  52. typedef struct {
  53.     ngx_http_regex_t             *regex;
  54.     void                         *value;
  55. } ngx_http_map_regex_t;


  56. ngx_http_regex_t *ngx_http_regex_compile(ngx_conf_t *cf,
  57.     ngx_regex_compile_t *rc);
  58. ngx_int_t ngx_http_regex_exec(ngx_http_request_t *r, ngx_http_regex_t *re,
  59.     ngx_str_t *s);

  60. #endif


  61. typedef struct {
  62.     ngx_hash_combined_t           hash;
  63. #if (NGX_PCRE)
  64.     ngx_http_map_regex_t         *regex;
  65.     ngx_uint_t                    nregex;
  66. #endif
  67. } ngx_http_map_t;


  68. void *ngx_http_map_find(ngx_http_request_t *r, ngx_http_map_t *map,
  69.     ngx_str_t *match);


  70. ngx_int_t ngx_http_variables_add_core_vars(ngx_conf_t *cf);
  71. ngx_int_t ngx_http_variables_init_vars(ngx_conf_t *cf);


  72. extern ngx_http_variable_value_t  ngx_http_variable_null_value;
  73. extern ngx_http_variable_value_t  ngx_http_variable_true_value;


  74. #endif /* _NGX_HTTP_VARIABLES_H_INCLUDED_ */