GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DOM_CHARACTERDATA (3)

NAME

DOM_CharacterData - the Document Object Model (DOM) DOM_CharacterData interface

CONTENTS

Synopsis
Description

SYNOPSIS


#include <domc.h> 

void DOM_CharacterData_deleteData(DOM_CharacterData *this);
DOM_String *DOM_CharacterData_substringData(DOM_CharacterData *this, int offset, int count);
void DOM_CharacterData_appendData(DOM_CharacterData *this, DOM_String *arg);
void DOM_CharacterData_insertData(DOM_CharacterData *this, int offset, DOM_String *arg);
void DOM_CharacterData_deleteData(DOM_CharacterData *this, int offset, int count);
void DOM_CharacterData_replaceData(DOM_CharacterData *this, int offset, int count, DOM_String *arg);

DESCRIPTION

The DOM_CharacterData interface provides some basic text manipulation functions for the DOM_Text, DOM_Comment, and DOM_CDATASection nodes. DOM_CharacterData nodes cannot be instatiated directly.

Currently all of these functions set DOM_Exception if an error occurs however there is no return value to detect the error event. A future version of DOMC will likely return a value that indicates that an error has occured.

DOM specifications require that character data is UTF-16 encoded. DOMC does not support UTF-16. The locale dependant 8 bit encoding is used instead. This permits common char * strings to be used in place of DOM_String *. Many UNIX and Linux systems support the UTF-8 locale. If a DOMC program is running in a UTF-8 locale the offsets of these string operations refer to characters rather than bytes or individual multibyte sequences. Thus the behavior of these functions should be very similar or identical to that of a DOM implementation that uses UTF-16. Also note that UTF-8 support may be disabled for the sake of installation simplicity. It may be necessary to obtain the source code and rebuild DOMC if i18n support is required.

getLength
  The DOM_CharacterData_getLength function returns the number of characters represented in this character data node.
substringData
  The DOM_CharacterData_substringData function returns a pointer to a string representing the substring beginning at the character at offset with a length of count. If the sum off offset and count exceeds the length of the character data, a string representing the remainder of the string is returned. Memory for the string is allocated with malloc(3) and may be freed with free(3). If the offset parameter is out of range DOM_Exception will be set to DOM_INDEX_SIZE_ERR.
appendData
  The DOM_CharacterData_appendData function appends the string arg to this character data node.
insertData
  The DOM_CharacterData_insertData function inserts the string arg into this character data at offset. If the offset parameter is out of range DOM_Exception will be set to DOM_INDEX_SIZE_ERR.
deleteData
  The DOM_CharacterData_deleteData function removes at most count characters at offset from the underlying string of this character data node. The resulting ends are concatonated together into one string. If the sum off offset and count exceeds the length of the character data, the resulting string will end at offset. If the offset parameter is out of range DOM_Exception will be set to DOM_INDEX_SIZE_ERR.
replaceData
  The DOM_CharacterData_replaceData function removes the character data at offset for count characters and inserts the string arg in it’s place. If the sum off offset and count exceeds the length of the character data, a string representing the remainder of the string is returned. If the offset parameter is out of range DOM_Exception will be set to DOM_INDEX_SIZE_ERR.

Search for    or go to Top of page |  Section 3 |  Main Index


domc-0.8.0 DOM_CHARACTERDATA (3m) Sep 9, 2004

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.