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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you 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 .
*/
/*
* This file is part of LibreOffice published API.
*/
#ifndef INCLUDED_RTL_URI_HXX
#define INCLUDED_RTL_URI_HXX
#include "rtl/malformeduriexception.hxx"
#include "rtl/uri.h"
#include "rtl/textenc.h"
#include "rtl/ustring.hxx"
#include "sal/types.h"
#if defined LIBO_INTERNAL_ONLY
#include <array>
#include <cassert>
#include <cstddef>
#include <string_view>
#include "config_global.h"
#endif
namespace rtl {
/** A wrapper around the C functions from <rtl/uri.h>.
*/
class Uri
{
public:
/** A wrapper around rtl_uriEncode() from <rtl/uri.h> (see there), using
an array of 128 booleans as char class.
*/
static inline rtl::OUString encode(rtl::OUString const & rText,
sal_Bool const * pCharClass,
rtl_UriEncodeMechanism eMechanism,
rtl_TextEncoding eCharset);
/** A wrapper around rtl_uriEncode() from <rtl/uri.h> (see there), using
a predefined rtl_UriCharClass enumeration member.
*/
static inline rtl::OUString encode(rtl::OUString const & rText,
rtl_UriCharClass eCharClass,
rtl_UriEncodeMechanism eMechanism,
rtl_TextEncoding eCharset);
/** A wrapper around rtl_uriDecode() from <rtl/uri.h> (see there).
*/
static inline rtl::OUString decode(rtl::OUString const & rText,
rtl_UriDecodeMechanism eMechanism,
rtl_TextEncoding eCharset);
/** A wrapper around rtl_uriConvertRelToAbs() from <rtl/uri.h> (see there).
@exception MalformedUriException
Thrown in case rtl_uriConvertRelToAbs() signals an exception due to a
malformed base URI.
*/
static inline rtl::OUString convertRelToAbs(
rtl::OUString const & rBaseUriRef, rtl::OUString const & rRelUriRef);
private:
Uri() SAL_DELETED_FUNCTION;
Uri(Uri &) SAL_DELETED_FUNCTION;
~Uri() SAL_DELETED_FUNCTION;
void operator =(Uri) SAL_DELETED_FUNCTION;
};
inline rtl::OUString Uri::encode(rtl::OUString const & rText,
sal_Bool const * pCharClass,
rtl_UriEncodeMechanism eMechanism,
rtl_TextEncoding eCharset)
{
rtl::OUString aResult;
rtl_uriEncode(const_cast< rtl::OUString & >(rText).pData,
pCharClass,
eMechanism,
eCharset,
&aResult.pData);
return aResult;
}
inline rtl::OUString Uri::encode(rtl::OUString const & rText,
rtl_UriCharClass eCharClass,
rtl_UriEncodeMechanism eMechanism,
rtl_TextEncoding eCharset)
{
rtl::OUString aResult;
rtl_uriEncode(const_cast< rtl::OUString & >(rText).pData,
rtl_getUriCharClass(eCharClass),
eMechanism,
eCharset,
&aResult.pData);
return aResult;
}
inline rtl::OUString Uri::decode(rtl::OUString const & rText,
rtl_UriDecodeMechanism eMechanism,
rtl_TextEncoding eCharset)
{
rtl::OUString aResult;
rtl_uriDecode(const_cast< rtl::OUString & >(rText).pData,
eMechanism,
eCharset,
&aResult.pData);
return aResult;
}
inline rtl::OUString Uri::convertRelToAbs(rtl::OUString const & rBaseUriRef,
rtl::OUString const & rRelUriRef)
{
rtl::OUString aResult;
rtl::OUString aException;
if (!rtl_uriConvertRelToAbs(
const_cast< rtl::OUString & >(rBaseUriRef).pData,
const_cast< rtl::OUString & >(rRelUriRef).pData, &aResult.pData,
&aException.pData))
throw MalformedUriException(aException);
return aResult;
}
#if defined LIBO_INTERNAL_ONLY
constexpr std::size_t UriCharClassSize = 128;
// Create a char class (for use with rtl_uriEncode and rtl::Uri::encode), represented as a
// compile-time std::array, from an UTF-8 string literal.
//
// The given `unencoded` lists each ASCII character once that shall not be encoded. (It uses an
// UTF-8 string type to emphasize that its characters' values are always interpreted as ASCII
// values.)
#if HAVE_CPP_CONSTEVAL
consteval
#else
constexpr
#endif
auto createUriCharClass(
#if defined __cpp_lib_char8_t
std::u8string_view
#else
std::string_view
#endif
unencoded)
{
std::array<sal_Bool, UriCharClassSize> a = {};
for (auto c: unencoded) {
assert(!a[c]); // would presumably indicate a typo in the `unencoded` argument
a[c] = true;
}
return a;
}
#endif
}
#endif // INCLUDED_RTL_URI_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
