~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/functions/string/position.rst

  • Committer: Evan Jones
  • Date: 2011-01-02 18:30:08 UTC
  • mto: (2055.1.2 build)
  • mto: This revision was merged to the branch mainline in revision 2056.
  • Revision ID: evanj@mit.edu-20110102183008-ytvoaig5zxdck3d5
libdrizzle: drizzle_state_read: only call recv() if data is available.

This uses the "read ready" flag that already exists to avoid excess system calls. Without this patch, in non-blocking mode after sending a command, libdrizzle immediately calls recv(), which almost always returns EAGAIN. This patch avoids that, instead returning IO_WAIT. This causes the caller to wait for data on the connection using poll() or epoll() before calling recv().

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Position Functions
2
 
==================
3
 
 
4
 
FIELD
5
 
-----
6
 
 
7
 
The FIELD function returns the index (position) of string arguments (str1, str2, str3, ….) 
8
 
 
9
 
It returns 0 if the str value is not found.
10
 
 
11
 
If each argument is a string, all arguments will be compared as strings, whereas if arguments are numbers, they will be compared as numbers.
12
 
 
13
 
Otherwise, the arguments are compared as double.
14
 
 
15
 
If str is NULL, the return value is 0 because NULL fails equality comparison with any value. FIELD() is the complement of ELT(). ::
16
 
 
17
 
        SELECT FIELD('ej', 'Hej', 'ej', 'Heja', 'hej', 'foo');
18
 
 
19
 
Returns 2 ::
20
 
        
21
 
        SELECT FIELD('fo', 'Hej', 'ej', 'Heja', 'hej', 'foo');
22
 
 
23
 
Returns 0
24
 
 
25
 
FIND_IN_SET
26
 
-----------
27
 
 
28
 
Return the index position of the first argument within the second argument
29
 
 
30
 
INSTR
31
 
-----
32
 
 
33
 
Return the index of the first occurrence of substring
34
 
 
35
 
LEFT
36
 
----
37
 
 
38
 
Return the leftmost number of characters as specified
39
 
 
40
 
INSERT
41
 
------
42
 
 
43
 
Insert a substring at the specified position up to the specified number of characters
44
 
 
45
 
LOCATE
46
 
------
47
 
 
48
 
Return the position of the first occurrence of substring
49
 
 
50
 
POSITION
51
 
--------
52
 
 
53
 
A synonym for LOCATE()
54