get_chapter_infoT_get_chapter_infoGetChapterInfoGetChapterInfoget_chapter_info (Operator)

Name

get_chapter_infoT_get_chapter_infoGetChapterInfoGetChapterInfoget_chapter_info — Get information concerning the chapters on operators.

Signature

get_chapter_info( : : Chapter : Info)

Herror T_get_chapter_info(const Htuple Chapter, Htuple* Info)

void GetChapterInfo(const HTuple& Chapter, HTuple* Info)

static HTuple HInfo::GetChapterInfo(const HTuple& Chapter)

static HTuple HInfo::GetChapterInfo(const HString& Chapter)

static HTuple HInfo::GetChapterInfo(const char* Chapter)

static HTuple HInfo::GetChapterInfo(const wchar_t* Chapter)   (Windows only)

static void HOperatorSet.GetChapterInfo(HTuple chapter, out HTuple info)

static HTuple HInfo.GetChapterInfo(HTuple chapter)

static HTuple HInfo.GetChapterInfo(string chapter)

def get_chapter_info(chapter: MaybeSequence[str]) -> Sequence[str]

Description

The operator get_chapter_infoget_chapter_infoGetChapterInfoGetChapterInfoGetChapterInfoget_chapter_info gives information concerning the chapters on operators. If instead of ChapterChapterChapterChapterchapterchapter the empty string is transmitted, the routine will provide in InfoInfoInfoInfoinfoinfo the names of all chapters. If on the other hand a certain chapter or a chapter and its subchapter(s) are indicated (by a tuple of names), the corresponding subchapters or - in case there are no further subchapters - the names of the corresponding operators will be given. The organization of the chapters on operators is the same as the organization of chapters and subchapters in the HALCON-manual. Please note: The chapters on operators respectively the subchapters concerning an individual operator can be called by using the operator get_operator_info(::<Name>,'chapter',Info:)get_operator_info(<Name>,"chapter",Info)GetOperatorInfo(<Name>,"chapter",Info)GetOperatorInfo(<Name>,"chapter",Info)GetOperatorInfo(<Name>,"chapter",Info)get_operator_info(<Name>,"chapter",Info). The Online-texts will be taken from the files operators_[LANG].ref, operators_[LANG].sta, operators_[LANG].num, operators_[LANG].key, and operators_[LANG].idx, which will be searched by HALCON in the currently used directory or the directory 'help_dir' (see also get_systemget_systemGetSystemGetSystemGetSystemget_system and set_systemset_systemSetSystemSetSystemSetSystemset_system).

Attention

The encoding of the result is ISO 8859-1 for English and German, and UTF-8 for Japanese.

Execution Information

Parameters

ChapterChapterChapterChapterchapterchapter (input_control)  string(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Operator class or subclass of interest.

Default value: '' "" "" "" "" ""

InfoInfoInfoInfoinfoinfo (output_control)  string-array HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Operator classes (ChapterChapterChapterChapterchapterchapter = ”) or operator subclasses respectively operators.

Result

If the parameter values are correct and the helpfile is available, the operator get_chapter_infoget_chapter_infoGetChapterInfoGetChapterInfoGetChapterInfoget_chapter_info returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

get_systemget_systemGetSystemGetSystemGetSystemget_system, set_systemset_systemSetSystemSetSystemSetSystemset_system

See also

get_operator_infoget_operator_infoGetOperatorInfoGetOperatorInfoGetOperatorInfoget_operator_info, get_systemget_systemGetSystemGetSystemGetSystemget_system, set_systemset_systemSetSystemSetSystemSetSystemset_system

Module

Foundation