1 | SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause |
---|
2 | brief: | |
---|
3 | Gets the object name associated with the object identifier as a string. |
---|
4 | copyrights: |
---|
5 | - Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) |
---|
6 | - Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) |
---|
7 | definition: |
---|
8 | default: |
---|
9 | attributes: null |
---|
10 | body: null |
---|
11 | params: |
---|
12 | - ${../../type/if/id:/name} ${.:/params[0]/name} |
---|
13 | - ${/c/if/size_t:/name} ${.:/params[1]/name} |
---|
14 | - char *${.:/params[2]/name} |
---|
15 | return: char * |
---|
16 | variants: [] |
---|
17 | description: | |
---|
18 | The object name is stored in the name buffer. If the name buffer length is |
---|
19 | greater than zero, then the stored object name will be ``NUL`` terminated. |
---|
20 | The stored object name may be truncated to fit the length. There is no |
---|
21 | indication if a truncation occurred. Every attempt is made to return name as |
---|
22 | a printable string even if the object has the Classic API 32-bit integer |
---|
23 | style name. |
---|
24 | enabled-by: true |
---|
25 | index-entries: [] |
---|
26 | interface-type: function |
---|
27 | links: |
---|
28 | - role: interface-placement |
---|
29 | uid: header |
---|
30 | - role: interface-ingroup |
---|
31 | uid: group |
---|
32 | name: rtems_object_get_name |
---|
33 | notes: | |
---|
34 | This directive may cause the calling task to be preempted due to an obtain |
---|
35 | and release of the object allocator mutex. |
---|
36 | params: |
---|
37 | - description: | |
---|
38 | is the object identifier to get the name. |
---|
39 | dir: null |
---|
40 | name: id |
---|
41 | - description: | |
---|
42 | is the buffer length in bytes. |
---|
43 | dir: null |
---|
44 | name: length |
---|
45 | - description: | |
---|
46 | is the pointer to a buffer of the specified length. |
---|
47 | dir: out |
---|
48 | name: name |
---|
49 | return: |
---|
50 | return: | |
---|
51 | Returns the ``${.:/params[2]/name}`` parameter value, if there is an object |
---|
52 | name associated with the object identifier. |
---|
53 | return-values: |
---|
54 | - description: | |
---|
55 | The ${.:/params[1]/name} parameter was 0. |
---|
56 | value: ${/c/if/null:/name} |
---|
57 | - description: | |
---|
58 | The ${.:/params[2]/name} parameter was ${/c/if/null:/name}. |
---|
59 | value: ${/c/if/null:/name} |
---|
60 | - description: | |
---|
61 | There was no object information available for the object identifier. |
---|
62 | value: ${/c/if/null:/name} |
---|
63 | - description: | |
---|
64 | There was no object associated with the object identifier. |
---|
65 | value: ${/c/if/null:/name} |
---|
66 | type: interface |
---|