Panel
Table of Contents

Anchor
1154955 1154955

Syntax

Wiki Markup
*find* _string_ seq=_sequence_ \[pos=_index_\] \[case=*yes*\|*no*\] \[num=_number_\|*last*\]

Anchor
1154958 1154958

Description

Anchor
1154959 1154959

The find command finds a specific occurrence of a substring in an existing string or list element.

Anchor
1154960 1154960

The first parameter, string, is the string in which to search for the sequence. It can be a variable reference or a literal. The seq parameter specifies the sequence for which the search is being made.

Anchor
1154961 1154961

The optional pos parameter specifies the one-based index of the string where the find operation begins.

Anchor
1154962 1154962

The optional case parameter indicates whether the search is case-sensitive (yes) or case-insensitive (no). Default = no.

Anchor
1154963 1154963

The optional num parameter specifies the instance of the sequence for which the search is being made. If the value of num is last, the find function gives back the index of the last occurrence of the sequence in the string.

Anchor
1154964 1154964

If the sequence is found, the index (one-based) of the starting point of the requested occurrence is place in the _lastrc.result variable. If the sequence was not found in the string, a value of -1 is placed in the _lastrc.result variable.

Anchor
1154965 1154965

If the sequence is found, _lastrc.message contains a value of MATCH. If the sequence could not be found, _lastrc.message contains NO_MATCH.

Anchor
1154966 1154966

Parameters

Anchor
1154994 1154994

HTML Table
cellspacing 0 style text-align: left; width: 100%; class Table_with_Header
Table Row (tr) Table Cell (td) style background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 144pt; Anchor 1154970 1154970 Parameter Table Cell (td) style background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 360pt; Anchor 1154972 1154972 Description Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154974 1154974 string Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154976 1154976 String in which to search for the sequence. Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154978 1154978 seq=sequence Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154980 1154980 Sequence for which the search is being made. Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154982 1154982 pos=index Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154984 1154984 One-based index of the string where the find operation begins. Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154986 1154986 case=yes | no Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154988 1154988 Specification of whether the search is case-sensitive (yes) or case-insensitive (no). Anchor 1154989 1154989 Default is no. Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154991 1154991 num=number | last Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1154993 1154993 Instance of the sequence for which the search is being made.

Anchor
1154996 1154996

Examples

Anchor
1154997 1154997

The following examples demonstrate the find command:

Panel

Anchor
1154931 1154931

Anchor
1154381 1154381