From ff92d19fed274c6469720cc726e80dc777fa767f Mon Sep 17 00:00:00 2001 From: "D. Shah" Date: Fri, 29 Jan 2021 11:11:08 +0000 Subject: arch: Add getNameDelimiter API for string lists Signed-off-by: D. Shah --- docs/archapi.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/archapi.md b/docs/archapi.md index 49183c63..6b9b0913 100644 --- a/docs/archapi.md +++ b/docs/archapi.md @@ -92,6 +92,10 @@ Get Z dimension for the specified tile for bels. All bels with at specified X an Get Z dimension for the specified tile for pips. All pips with at specified X and Y coordinates must have a Z coordinate in the range `0 .. getTileDimZ(X,Y)-1` (inclusive). +### char getNameDelimiter() const + +Returns a delimiter that can be used to build up bel, wire and pip names out of hierarchical components (such as tiles and sites) to avoid the high memory usage of storing full names for every object. + Cell Methods ----------- @@ -99,7 +103,6 @@ Cell Methods Get list of cell types that this architecture accepts. - Bel Methods ----------- -- cgit v1.2.3 From 9614d3722929f99520c6b83600641c14ef37188b Mon Sep 17 00:00:00 2001 From: "D. Shah" Date: Fri, 29 Jan 2021 13:03:11 +0000 Subject: docs: Update archapi.md with IdStringList Signed-off-by: D. Shah --- docs/archapi.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) (limited to 'docs') diff --git a/docs/archapi.md b/docs/archapi.md index 6b9b0913..e3c06efd 100644 --- a/docs/archapi.md +++ b/docs/archapi.md @@ -106,11 +106,11 @@ Get list of cell types that this architecture accepts. Bel Methods ----------- -### BelId getBelByName(IdString name) const +### BelId getBelByName(IdStringList name) const -Lookup a bel by its name. +Lookup a bel by its name, which is a list of IdStrings joined by `getNameDelimiter()`. -### IdString getBelName(BelId bel) const +### IdStringList getBelName(BelId bel) const Get the name for a bel. (Bel names must be unique.) @@ -186,11 +186,11 @@ Return a list of all pins on that bel. Wire Methods ------------ -### WireId getWireByName(IdString name) const +### WireId getWireByName(IdStringList name) const -Lookup a wire by its name. +Lookup a wire by its name, which is a list of IdStrings joined by `getNameDelimiter()`. -### IdString getWireName(WireId wire) const +### IdStringList getWireName(WireId wire) const Get the name for a wire. (Wire names must be unique.) @@ -262,11 +262,11 @@ of the bounds is almost always better than an under-estimate. Pip Methods ----------- -### PipId getPipByName(IdString name) const +### PipId getPipByName(IdStringList name) const -Lookup a pip by its name. +Lookup a pip by its name, which is a list of IdStrings joined by `getNameDelimiter()`. -### IdString getPipName(PipId pip) const +### IdStringList getPipName(PipId pip) const Get the name for a pip. (Pip names must be unique.) @@ -353,11 +353,11 @@ Get all pips uphill of a wire, i.e. pips that use this wire as destination wire. Group Methods ------------- -### GroupId getGroupByName(IdString name) const +### GroupId getGroupByName(IdStringList name) const -Lookup a group by its name. +Lookup a group by its name, which is a list of IdStrings joined by `getNameDelimiter()`. -### IdString getGroupName(GroupId group) const +### IdStringList getGroupName(GroupId group) const Get the name for a group. (Group names must be unique.) -- cgit v1.2.3