/usr/include/xmltooling/util/URLEncoder.h is in libxmltooling-dev 1.5.3-2+deb8u3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /**
* Licensed to the University Corporation for Advanced Internet
* Development, Inc. (UCAID) under one or more contributor license
* agreements. See the NOTICE file distributed with this work for
* additional information regarding copyright ownership.
*
* UCAID 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
*
* 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.
*/
/**
* @file xmltooling/util/URLEncoder.h
*
* Interface to a URL-encoding mechanism along with a default implementation.
*/
#ifndef __xmltool_urlenc_h__
#define __xmltool_urlenc_h__
#include <xmltooling/base.h>
namespace xmltooling {
/**
* Interface to a URL-encoding mechanism along with a default implementation.
*
* Since URL-encoding is not canonical, it's important that the same
* encoder is used during some library operations and the calling code.
* Applications can supply an alternative implementation to the library
* if required.
*/
class XMLTOOL_API URLEncoder {
MAKE_NONCOPYABLE(URLEncoder);
public:
URLEncoder();
virtual ~URLEncoder();
/**
* Produce a URL-safe but equivalent version of the input string.
*
* @param s input string to encode
* @return a string object containing the result of encoding the input
*/
virtual std::string encode(const char* s) const;
/**
* Perform an in-place decoding operation on the input string.
* The resulting string will be NULL-terminated.
*
* @param s input string to decode in a writable buffer
*/
virtual void decode(char* s) const;
protected:
/**
* Returns true iff the input character requires encoding.
*
* @param ch the character to check
* @return true iff the character should be encoded
*/
virtual bool isBad(char ch) const;
};
};
#endif /* __xmltool_urlenc_h__ */
|