Daylight v4.9
Release Date: 1 February 2008

Name

dt_alloc_vbind - allocate a vector binding

Generic Prototype

dt_alloc_vbind(dt_String) => dt_Handle

C Prototype

#include "dt_smarts.h"

dt_Handle dt_alloc_vbind(dt_Integer strlen, dt_String string)

FORTRAN Prototype

include 'dt_f_smarts.inc'

integer*4 dt_f_alloc_vbind(string)

character*() string

Description

If a vector binding with the specified name already exists, returns that object. Otherwise, creates a new vector binding and gives it the specified name.

The string name must begin with a letter; subsequent characters in the name must be letters, numbers, or the underscore. The name must match the UNIX regular expression: /^[a-zA-Z][a-zA-Z0-9_]*$/

Return Value

Returns a new vector binding object or NULL_OB if 'string' is inappropriate.

Related Topics

dt_alloc_pathset(3) dt_getval(3) dt_match(3) dt_name(3) dt_setval(3) dt_smartin(3) dt_smarts_opt(3) dt_umatch(3) dt_vmatch(3)