summaryrefslogtreecommitdiff
path: root/docs/reference/tmpl/soup-method.sgml
blob: 5969dec97eb23df6d9d72ef1c7dd6ce6b942adff (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
<!-- ##### SECTION Title ##### -->
soup-method

<!-- ##### SECTION Short_Description ##### -->
HTTP method definitions

<!-- ##### SECTION Long_Description ##### -->
<para>
soup-method.h contains a number of defines for standard HTTP and
WebDAV headers. You do not need to use these defines; you can pass
arbitrary strings to soup_message_new() if you prefer.
</para>

<para>
The thing that these defines <emphasis>are</emphasis> useful for is
performing quick comparisons against #SoupMessage's %method field;
because that field always contains an interned string, and these
macros return interned strings, you can compare %method directly
against these macros rather than needing to use strcmp(). This is most
useful in SoupServer handlers. Eg:
</para>

<informalexample><programlisting>
	if (msg->method != SOUP_METHOD_GET &amp;&amp; msg->method != SOUP_METHOD_HEAD) {
		soup_message_set_status (msg, SOUP_METHOD_NOT_IMPLEMENTED);
		return;
	}
</programlisting></informalexample>

<!-- ##### SECTION See_Also ##### -->
<para>
g_intern_string()
</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### MACRO SOUP_METHOD_OPTIONS ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_GET ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_HEAD ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_PUT ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_POST ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_DELETE ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_TRACE ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_CONNECT ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_PROPFIND ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_PROPPATCH ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_MKCOL ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_COPY ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_MOVE ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_LOCK ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_UNLOCK ##### -->
<para>

</para>



<!-- ##### MACRO SOUP_METHOD_PATCH ##### -->
<para>

</para>