/usr/include/sipxtapi/utl/XmlContent.h is in libsipxtapi-dev 3.3.0~test17-1.
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 76 77 78 79 80 81 82 83 84 | //
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp. All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////
#ifndef _XmlContent_h_
#define _XmlContent_h_
// SYSTEM INCLUDES
#include "os/OsDefs.h"
// APPLICATION INCLUDES
#include "utl/UtlString.h"
// DEFINES
#define XML_VERSION_1_0 "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
/**
* XmlContent provides conversion functions for escaping and unescaping UtlStrings
* as appropriate for use in XML attribute and element content.
*
* At present, this makes no accomodation for character set differences; input is assumed
* to be 8 bits. The following characters are encoded using the mandatory character
* entities:
* - < => <
* - & => &
* - > => >
* - ' => '
* - " => "
*
* Other character values outside the range of valid 8-bit characters in XML:
* - #x09 | #x0A | #x0D | [#x20-#FF]
* are encoded using the numeric entity encoding (&#x??;).
*
* While this is not strictly XML conformant (in that it does not explicitly deal with
* larger-size character encodings), it is symmetric (esaping and unescaping any string
* these routines will always produce the original string), and will interoperate correctly
* for any 8 bit encoding.
*/
/// Append escaped source string onto destination string
bool XmlEscape(UtlString& destination, const UtlString& source);
/**<
* The contents of the source string are appended to the destination string, with all
* characters escaped as described above.
* @returns true for success, false if an error was returned from any UtlString operation.
*/
/// Append unescaped source string onto destination string
bool XmlUnEscape(UtlString& destination, const UtlString& source);
/**<
* The contents of the source string are appended to the destination string, with all
* characters unescaped as described above.
* @returns true for success, false if an error was returned from any UtlString operation.
*/
/// Append decimal string onto destination string
bool XmlDecimal(UtlString& destination,
int source,
const char* format = NULL);
/**<
* The source value is converted into a decimal string according to
* "format". The decimal string is appended to the destination string.
* "format" defaults to "%d", and must generate no more than 20 characters,
* (excluding the ending NUL).
* @returns true for success, false if an error was returned from any UtlString operation.
*/
#endif // _XmlContent_h_
|