mirror of
https://github.com/NishiOwO/tkwww.git
synced 2025-04-21 16:54:40 +00:00
398 lines
9.2 KiB
C
398 lines
9.2 KiB
C
/* Anchor object for libwww
|
|
HYPERTEXT "ANCHOR" OBJECT
|
|
|
|
An anchor represents a region of a hypertext document which is linked to another anchor
|
|
in the same or a different document.
|
|
|
|
*/
|
|
#ifndef HTANCHOR_H
|
|
#define HTANCHOR_H
|
|
|
|
/* Version 0 (TBL) written in Objective-C for the NeXT browser */
|
|
/* Version 1 of 24-Oct-1991 (JFG), written in C, browser-independant */
|
|
|
|
#include "HTList.h"
|
|
#include "HTAtom.h"
|
|
|
|
/*
|
|
|
|
SHORT NAMES
|
|
|
|
*/
|
|
#ifdef SHORT_NAMES
|
|
#define HTAnchor_findChild HTAnFiCh
|
|
#define HTAnchor_findChildAndLink HTAnFiLi
|
|
#define HTAnchor_findAddress HTAnFiAd
|
|
#define HTAnchor_delete HTAnDele
|
|
#define HTAnchor_makeLastChild HTAnMaLa
|
|
#define HTAnchor_parent HTAnPare
|
|
#define HTAnchor_setDocument HTAnSeDo
|
|
#define HTAnchor_document HTAnDocu
|
|
#define HTAnchor_setFormat HTAnSeFo
|
|
#define HTAnchor_format HTAnForm
|
|
#define HTAnchor_setIndex HTAnSeIn
|
|
#define HTAnchor_isIndex HTAnIsIn
|
|
#define HTAnchor_address HTAnAddr
|
|
#define HTAnchor_hasChildren HTAnHaCh
|
|
#define HTAnchor_title HTAnTitl
|
|
#define HTAnchor_setTitle HTAnSeTi
|
|
#define HTAnchor_appendTitle HTAnApTi
|
|
#define HTAnchor_link HTAnLink
|
|
#define HTAnchor_followMainLink HTAnFoMa
|
|
#define HTAnchor_followTypedLink HTAnFoTy
|
|
#define HTAnchor_makeMainLink HTAnMaMa
|
|
#define HTAnchor_setProtocol HTAnSePr
|
|
#define HTAnchor_protocol HTAnProt
|
|
#define HTAnchor_physical HTAnPhys
|
|
#define HTAnchor_setPhysical HTAnSePh
|
|
#define HTAnchor_methods HtAnMeth
|
|
#endif
|
|
|
|
/*
|
|
|
|
Anchor data structures
|
|
|
|
*/
|
|
typedef struct _HyperDoc HyperDoc; /* Ready for forward references */
|
|
typedef struct _HTAnchor HTAnchor;
|
|
typedef struct _HTParentAnchor HTParentAnchor;
|
|
typedef struct _HTChildAnchor HTChildAnchor;
|
|
|
|
/*
|
|
|
|
Must be AFTER definition of HTAnchor:
|
|
|
|
*/
|
|
#include "HTFormat.h"
|
|
|
|
typedef HTAtom HTLinkType;
|
|
|
|
typedef struct {
|
|
HTAnchor * dest; /* The anchor to which this leads */
|
|
HTLinkType * type; /* Semantics of this link */
|
|
} HTLink;
|
|
|
|
/*
|
|
|
|
GENERIC ANCHOR TYPE
|
|
|
|
*/
|
|
struct _HTAnchor { /* Generic anchor : just links */
|
|
HTLink mainLink; /* Main (or default) destination of this */
|
|
HTList * links; /* List of extra links from this, if any */
|
|
/* We separate the first link from the others to avoid too many small mallocs
|
|
involved by a list creation. Most anchors only point to one place. */
|
|
HTParentAnchor * parent; /* Parent of this anchor (self for adults) */
|
|
};
|
|
|
|
/*
|
|
|
|
ANCHOR FOR A WHOLE OBJECT
|
|
|
|
*/
|
|
struct _HTParentAnchor {
|
|
/* Common part from the generic anchor structure */
|
|
HTLink mainLink; /* Main (or default) destination of this */
|
|
HTList * links; /* List of extra links from this, if any */
|
|
HTParentAnchor * parent; /* Parent of this anchor (self) */
|
|
|
|
/* ParentAnchor-specific information */
|
|
HTList * children; /* Subanchors of this, if any */
|
|
HTList * sources; /* List of anchors pointing to this, if any */
|
|
HyperDoc * document; /* The document within which this is an anchor */
|
|
char * address; /* Absolute address of this node */
|
|
HTFormat format; /* Pointer to node format descriptor */
|
|
BOOL isIndex; /* Acceptance of a keyword search */
|
|
char * title; /* Title of document */
|
|
|
|
HTList* methods; /* Methods available as HTAtoms */
|
|
void * protocol; /* Protocol object */
|
|
char * physical; /* Physical address */
|
|
HTList * cacheItems ; /* Cache hits (see HTFWriter ) for this URL */
|
|
long int size; /* Indicative size only if multiformat */
|
|
};
|
|
|
|
/*
|
|
|
|
ANCHOR FOR A FRAGMENT OF AN OBJECT
|
|
|
|
*/
|
|
struct _HTChildAnchor {
|
|
/* Common part from the generic anchor structure */
|
|
HTLink mainLink; /* Main (or default) destination of this */
|
|
HTList * links; /* List of extra links from this, if any */
|
|
HTParentAnchor * parent; /* Parent of this anchor */
|
|
|
|
/* ChildAnchor-specific information */
|
|
char * tag; /* Address of this anchor relative to parent */
|
|
};
|
|
|
|
/*
|
|
|
|
Class methods
|
|
|
|
HTANCHOR_FINDCHILD: CREATE NEW OR FIND OLD SUB-ANCHOR
|
|
|
|
This one is for a new anchor being edited into an existing document. The parent anchor
|
|
must already exist.
|
|
|
|
*/
|
|
extern HTChildAnchor * HTAnchor_findChild
|
|
PARAMS(
|
|
(HTParentAnchor *parent,
|
|
CONST char *tag)
|
|
);
|
|
|
|
/*
|
|
|
|
HTANCHOR_FINDCHILDANDLINK: CREATE OR FIND A CHILD ANCHOR WITH A POSSIBLE LINK
|
|
|
|
Create new anchor with a given parent and possibly a name, and possibly a link to a
|
|
_relatively_ named anchor.
|
|
|
|
*/
|
|
extern HTChildAnchor * HTAnchor_findChildAndLink
|
|
PARAMS((
|
|
HTParentAnchor * parent, /* May not be 0 */
|
|
CONST char * tag, /* May be "" or 0 */
|
|
CONST char * href, /* May be "" or 0 */
|
|
HTLinkType * ltype /* May be 0 */
|
|
));
|
|
|
|
|
|
/*
|
|
|
|
CREATE NEW OR FIND OLD NAMED ANCHOR
|
|
|
|
*/
|
|
|
|
/*
|
|
|
|
This one is for a reference which is found in a document, and might not be already
|
|
loaded. Note: You are not guaranteed a new anchor -- you might get an old one, like
|
|
with NXFonts.
|
|
|
|
*/
|
|
extern HTAnchor * HTAnchor_findAddress
|
|
PARAMS(
|
|
(CONST char * address)
|
|
);
|
|
|
|
|
|
/*
|
|
|
|
HTANCHOR_DELETE: DELETE AN ANCHOR
|
|
|
|
Also possibly delete related things (auto garbage collection)
|
|
|
|
The anchor is only deleted if the corresponding document is not loaded. All outgoing
|
|
links from parent and children are deleted, and this anchor is removed from the sources
|
|
list of all its targets. We also try to delete the targets whose documents are not
|
|
loaded. If this anchor's source list is empty, we delete it and its children.
|
|
|
|
*/
|
|
extern BOOL HTAnchor_delete
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
|
|
|
|
/*
|
|
|
|
HTANCHOR_MAKELASTCHILD: MOVE AN ANCHOR TO THE HEAD OF THE LIST OF ITS SIBLINGS
|
|
|
|
This is to ensure that an anchor which might have already existed is put in the correct
|
|
order as we load the document.
|
|
|
|
*/
|
|
|
|
|
|
extern void HTAnchor_makeLastChild
|
|
PARAMS(
|
|
(HTChildAnchor *me)
|
|
);
|
|
|
|
/*
|
|
|
|
Accessing propertiesof the anchor
|
|
|
|
*/
|
|
|
|
|
|
extern HTParentAnchor * HTAnchor_parent
|
|
PARAMS(
|
|
(HTAnchor *me)
|
|
);
|
|
|
|
extern void HTAnchor_setDocument
|
|
PARAMS(
|
|
(HTParentAnchor *me, HyperDoc *doc)
|
|
);
|
|
|
|
extern HyperDoc * HTAnchor_document
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
/* We don't want code to change an address after anchor creation... yet ?
|
|
extern void HTAnchor_setAddress
|
|
PARAMS(
|
|
(HTAnchor *me, char *addr)
|
|
);
|
|
*/
|
|
|
|
/*
|
|
|
|
HTANCHOR_ADDRESS
|
|
|
|
Returns the full URI of the anchor, child or parent as a malloc'd string to be freed by
|
|
the caller.
|
|
|
|
*/
|
|
|
|
extern char * HTAnchor_address
|
|
PARAMS(
|
|
(HTAnchor *me)
|
|
);
|
|
|
|
/*
|
|
|
|
FORMAT OF SOURCE
|
|
|
|
*/
|
|
extern void HTAnchor_setFormat
|
|
PARAMS(
|
|
(HTParentAnchor *me, HTFormat form)
|
|
);
|
|
|
|
extern HTFormat HTAnchor_format
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
|
|
/*
|
|
|
|
IS IT SEARCHABLE?
|
|
|
|
*/
|
|
extern void HTAnchor_setIndex
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
|
|
extern BOOL HTAnchor_isIndex
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
|
|
/*
|
|
|
|
DOES IT HAVE ANY ANCHORS WITHIN IT?
|
|
|
|
*/
|
|
extern BOOL HTAnchor_hasChildren
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
|
|
/*
|
|
|
|
LIST OF METHODS WHICH CAN OPERATE ON OBJECT
|
|
|
|
*/
|
|
extern HTList * HTAnchor_methods PARAMS((HTParentAnchor *me));
|
|
|
|
/*
|
|
|
|
PROTOCOL
|
|
|
|
*/
|
|
extern void * HTAnchor_protocol PARAMS((HTParentAnchor * me));
|
|
extern void HTAnchor_setProtocol PARAMS((HTParentAnchor * me,
|
|
void* protocol));
|
|
|
|
/*
|
|
|
|
PHYSICAL ADDRESS
|
|
|
|
*/
|
|
extern char * HTAnchor_physical PARAMS((HTParentAnchor * me));
|
|
extern void HTAnchor_setPhysical PARAMS((HTParentAnchor * me,
|
|
char * protocol));
|
|
|
|
/*
|
|
|
|
Title handling
|
|
|
|
*/
|
|
|
|
extern CONST char * HTAnchor_title
|
|
PARAMS(
|
|
(HTParentAnchor *me)
|
|
);
|
|
|
|
extern void HTAnchor_setTitle
|
|
PARAMS(
|
|
(HTParentAnchor *me, CONST char * title)
|
|
);
|
|
|
|
extern void HTAnchor_appendTitle
|
|
PARAMS(
|
|
(HTParentAnchor *me, CONST char * title)
|
|
);
|
|
|
|
|
|
/*
|
|
|
|
Manipulation of Links
|
|
|
|
LINK THIS ANCHOR TO ANOTHER GIVEN ONE
|
|
|
|
*/
|
|
|
|
extern BOOL HTAnchor_link
|
|
PARAMS(
|
|
(HTAnchor *source, HTAnchor *destination, HTLinkType *type)
|
|
);
|
|
|
|
/*
|
|
|
|
FIND DESTINATION OF LINK
|
|
|
|
*/
|
|
extern HTAnchor * HTAnchor_followMainLink
|
|
PARAMS(
|
|
(HTAnchor *me)
|
|
);
|
|
|
|
/*
|
|
|
|
FIND DESTINATION WITH GIVEN RELATIONSHIP
|
|
|
|
*/
|
|
extern HTAnchor * HTAnchor_followTypedLink
|
|
PARAMS(
|
|
(HTAnchor *me, HTLinkType *type)
|
|
);
|
|
|
|
/*
|
|
|
|
MAKE A PARTICULAR LINK THE MAIN LINK
|
|
|
|
*/
|
|
extern BOOL HTAnchor_makeMainLink
|
|
PARAMS(
|
|
(HTAnchor *me, HTLink *movingLink)
|
|
);
|
|
|
|
|
|
#endif /* HTANCHOR_H */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
*/
|