|
| void | ds_add_page_field (ds_data_t *data, int32_t fieldnum, const char *value) |
| | Add an arbitrary field to a page. More...
|
| |
| void | ds_add_page_field_by_name (ds_data_t *data, const char *field, const char *value) |
| | Add an arbitrary field to a page. More...
|
| |
| void | ds_add_page_row (ds_data_t *data, int row, int col, const char *str) |
| | Add a row of data to a page data object. More...
|
| |
| ds_data_t * | ds_init_page (const char *subject, int rows, int cols, const char *type, unsigned short flags) |
| | Initialise a data object as a page. More...
|
| |
DataSource supports the contribution of pages, or sections of pages. Any individual character on a page can be updated.
- See also
- Sending DataSource Objects to Peers
-
Data Object Flags
| void ds_add_page_field |
( |
ds_data_t * |
data, |
|
|
int32_t |
fieldnum, |
|
|
const char * |
value |
|
) |
| |
Add an arbitrary field to a page.
- Parameters
-
| data | Page data object |
| fieldnum | Field number |
| value | Value of the field |
This function can be used to add extra meta-data to page objects eg permissioning values for content based permissioning.
- Note
- Only field numbers up to 16383 are supported.
- See also
- ds_add_page_field_by_name()
| void ds_add_page_field_by_name |
( |
ds_data_t * |
data, |
|
|
const char * |
field, |
|
|
const char * |
value |
|
) |
| |
Add an arbitrary field to a page.
- Parameters
-
| data | Page data object |
| field | Field name |
| value | Value of the field |
This function can be used to add extra meta-data to page objects eg permissioning values for content based permissioning
- See also
- ds_add_page_field()
| void ds_add_page_row |
( |
ds_data_t * |
data, |
|
|
int |
row, |
|
|
int |
col, |
|
|
const char * |
str |
|
) |
| |
Add a row of data to a page data object.
- Parameters
-
| data | The page data object |
| row | The row number to be added |
| col | The column to start at |
| str | The value of the data |
| ds_data_t* ds_init_page |
( |
const char * |
subject, |
|
|
int |
rows, |
|
|
int |
cols, |
|
|
const char * |
type, |
|
|
unsigned short |
flags |
|
) |
| |
Initialise a data object as a page.
- Parameters
-
| subject | The name of the object |
| rows | Number of rows |
| cols | Number of columns |
| type | Option type string |
| flags | Object flags |
Pages can be any size up to a maximum of 256 rows and 191 columns. The flags argument should contain F_IMAGE on the first update to set the size, however this is not required if the page is the standard 80 columns by 25 rows.
