8.13 Find phonebook entries +CPBF

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Table 73: +CPBF action command syntax

Command

Possible response(s)

+CPBF=<findtext>

[+CPBF: <index1>,<number>,<type>,<text>[,<hidden>][,<group>][,<adnumber>][,<adtype>][,<secondtext>][,<email>][,<sip_uri>][,<tel_uri>]]

[<CR><LF>+CBPF: <index2>,<number>,<type>,<text>[,<hidden>][,<group>][,<adnumber>][,<adtype>][,<secondtext>][,<email>][,<sip_uri>][,<tel_uri>]

[…]]

+CME ERROR: <err>

+CPBF=?

+CPBF: [<nlength>],[<tlength>],[<glength>],[<slength>],[<elength>],[<siplength>],[<tellength>]

+CME ERROR: <err>

Description

Execution command returns phonebook entries (from the current phonebook memory storage selected with +CPBS) which alphanumeric field start with string <findtext>. Entry fields returned are location number <indexn>, phone number stored there <number> (of format <type>), text <text> associated with the number, if the selected phonebook supports hidden entries, <hidden> indicating if the entry is hidden, <group> indicating a group the entry may belong to, <adnumber> an additional number (of format <adtype>), <secondtext> a second text field associated with the number, <email> an email field, <sip_uri> SIP number and <tel_uri> TEL number. If listing fails in an MT error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.

Test command returns the maximum lengths of <number>, <text>, <group>, <secondtext>, <email>, <sip_uri> and <tel_uri> fields. In case of (U)SIM storage, the lengths may not be available. If MT is not currently reachable, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.

Defined values

<index1>, <index2>: integer type values in the range of location numbers of phonebook memory

<number>: string type phone number of format <type>

<type>: type of address octet in integer format (refer 3GPP TS 24.008 [8] clause 10.5.4.7)

<group>: string type field of maximum length <glength>; character set as specified by command select TE character set +CSCS

<adnumber>: string type phone number of format <adtype>

<adtype>: type of address octet in integer format (refer 3GPP TS 24.008 [8] clause 10.5.4.7)

<secondtext>: string type field of maximum length <slength>; character set as specified by command select TE character set +CSCS

<email>: string type field of maximum length <elength>; character set as specified by command select TE character set +CSCS

<findtext>, <text>: string type field of maximum length <tlength>; character set as specified by command select TE character set +CSCS

<sip_uri>: string type field of maximum length <siplength>; character set as specified by command select TE character set +CSCS

<tel_uri>: string type phone number of maximum length <tellength>; character set as specified by command select TE character set +CSCS

<nlength>: integer type value indicating the maximum length of field <number>

<tlength>: integer type value indicating the maximum length of field <text>

<glength>: integer type value indicating the maximum length of field <group>

<slength>: integer type value indicating the maximum length of field <secondtext>

<elength>: integer type value indicating the maximum length of field <email>

<siplength>: integer type value indicating the maximum length of field <sip_uri>

<tellength>: integer type value indicating the maximum length of field <tel_uri>

<hidden>: integer type value indicates if the entry is hidden or not

0: phonebook entry not hidden

1: phonebook entry hidden

Implementation

Optional.